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This nanual describes the pnP~ll Cassette Progranning SystGn and 
provides all the information necessary for normal uRagc. It requires 
no prior experience on a PDP-11 conputer, but does assume some 
exposure to assttnfoly language proarainining and computer systems in 
general. Upon receiving his syston^p the user should first read 
through the entire CWB-Il raanu=*tl, then reconfigure his system {if 
necessary) according to the instructions provided in Appendix F; 
/— N lastly J he should try the demonstration program run in Appendix D. 

Frequent reference is nado to two suppler.entfiry handbooks which the 
user should also receive with his systen. These are: THE PDP-ll 
PERIPHERALS AND IMTERFACINtt HAtJDBOOK and THE PDP-11 PROCESSOR 
HAKDDOOK. The latter handbook may be any one of several Processor 
Handbooks, each geared to a particular PDP-11 Processor C11/20/15/R20, 
11/45, etc.)? the handbook received with a CAPS-11 System depends upon 
the processor purchased. 

If the user intends to write his owm cassette handler or if he will 
use IMonitor cassette prinitivcs, he should familiarize himself with 
-""^ the TAll CASSETTB lOTERFACE SYSTEM manual (DEC-ll-HTACA-A-D) , the TU60 

CASSETTE TAPE TRANSPORT MAItJTEIIAHCE MAMUAL |DEC-00-TU60-nA) , and the 
Cassette Standard {Appendix F of this manual) . 

several different configurations are possible with the Cassette 
Programming System, For documentation purposes, the following 
configuration is assunedit PDP-11/10 processor, LA.30 DECwriter, LSll 
line printer. 

Documentation conventions include the follo^iFings 

y»v 1. Actual ccx«iputer output is used in exanples tsrherever possible, 

IJhen necessary, computer printout is underlined to 

differentiate it from user responses, 

2, To avoid confusion, a line feed is represented in the text as 

I J a carriage return is represented by ^ . Unless 
otheCT<?ise indicated, all commands and command strings are 
terminated by a carriage return, 

3, Terminal, console terminal, and teleprinter are general terms 
used throughout the documentation to represent any one of the 
following! LA30 DECwriter, VT05 Display, LT33 or 35 Teletype. 

4, Several characters uscid in system commands are produced by a 
combination of t\m keys typed at the same time. Generally, 
the combinations are SHIFT and some other key (such as SfriPT 
and N to produce the uparrcsfi character on an LT33 or 35) or 
CTRL and another key {for example, CTRL and O produces a 
conmand which causes suppression of teleprinter output) , 

/*~^ These key combinations are documented as SHIFT /N, CTRL/0, 

etc, respectively. 



'"' J* -Hfttt <d*- 



Portions of coranand strings which are enclosed In square 
brackets are optional — the user may type them or not as he 
chooses without chanaing the intention of the coi".raand. 

Certain keyboard variances prevail amona teleprinters which 
may be used as the consols temlnal in a CAPS-11 fiysten; 

these concern labeling of keyboard keys and characters output 
upon receipt of particular ASCII character codes. Refer to 
Appendix A for a list of possible differences. 



XIV 



CT'APTr^ 1 
THK CAP51-11 PROGRA'IMIMG SYPTEf 



The PnP-11 Caosctte Progr.-inriinq Ry^ton (CAPF;-11) is a snail 
progranrnina oystcn for the PDP-11 computer dcsicined aroun'l the use of 
caSsnttGS for proaran and data stnraoc. CAPR-ll providns the user 
v/ith the canability of pcrforning all file transfers, proqran 
devolonnpnt , loadinn, and fitorano vi n ca.snf'ttf?. The systen also 
provides riininal support for usinq^ paper tape by allnvfina the nser v/ho 
has paper tape proqrans to transfer thoscj prograns to cassette and 
vice versa. 

CAPS-11 providfis the uncr with a Koyboard "-tonitor, I/O facilities at 
the Monitor level, and a library of systen pronrans , lncl\idinq a 
machine languagG asscnblcr, an etiitor, and a dcbugqina proqran. 
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l.l SYSTEM OONFIC^RATION 

A CAPS-11 minimal system configuration consists of the following 
hardware and software conponents. Optional memory and peripheral 
devices may be added as desired. 



1.1.1 Hardware Conponents 

The PDP-ll Cassette Prograirming Systepi is built around any PDP-11 
processor \rith one <only) TAll controller, a console terminal (IA30 
IIECwriter, LT33 or LT35 Teletype, or VT05 DECterrainal) , and 8K Cor as 
much as 28K) of memory. A line printer (LPll or LSll) is optional. A 
high-speed paper tape reader and punch are also optional and may be 
used by PIP. 

Section 1.5 describes operational procedures for the PDP-11/10 
processor, LA30 DECwriter, smd LSll line printer, as these devices are 
considered representative of a standard CAPS- 11 System configuration. 



1,1.2 Software Caifiponents 

CAPS-11 software is provided on three cassettes — 'two OBJ Cassettes and 
a system Cassette, The OBJ Cassettes are used exclusively for 
changing and building eystew confitmrations and are explained in 
Appendix E. A brief description of the aoftsiare package stored on the 
System Cassette folloiirs. Each proqram is discussed in greater detail 
later in the roaniial. 

1. Monitor - The Keyboard Monitor provides copinunication between 
the user and the Cassette System executive routines by 
accepting c<»mands from the console terminal keyboard. The 
commands allow the user to run system and user programs, load 
and start prograns using inaxii^xira memory space, and obtain 
directories of cassettes. 

2. Symbolic Editor - The Editor allows the user to modify or 
create source files for use as input to the Assembler. The 
Editor ccaitains powerful text manipulation conmands for quick 

and easy editing. 

3. PAL Assembler - The i^sembler (Program Assembly Language) 
accepts source files in the PAL machine language and 
generates binary object raodules (and/or assembly listings) as 
output. These object raodules can then be linked, loaded and 
executed. 

4. Linker - The Linker converts relocatable object modules 
produced by the Assembler into absolute load modules for 
program loading and execuCion. The Linker also produces a 
load map which displays the assigned absolute addresses. 

5. ODT - The OUT (On-Line Debugging Technicjuel program aids the 
progranmer in debugging his object program by allowing him to 
examine, change, and run any portion of his prograiti on-line 
using simple commands typed on the console terminal. 
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6. RESMDM - The Input/Output package (RRSf'VN) provides routines 
for all input/output pragrannino in the CAPS-11 Systen. User 
prograns can cormunicate v^ith RESTIOW (via lOT instructions 
%jhich utilize KESflON) to create cassette files and perform 
all console terminal and line printer I/O. 

7. PIP - PIP {Peripheral Interchanae Proqram) allows the user to 
transfer files from one cassette to another or to the console 

tenrsinal or line printer and to delete files from cassette. 
PIP also provides mininal support for paper tape usage by 
allowinq prograp.s to be transferred from cassette to the 
high-speed paper tape punch and from the high-speed paper 
tape reader to cassette. 



1.2 KllAT IS A CAPS- 11 CAKPETTE? 

A CAPS-11 cassette is a magnetic tape device nuch like that used in a 
cassette tape recorder, ^he tape itself and the reels it is wound on 
are enclosed inside a rectangular plastic case (see Figure 1-2) , 
making handling, storage, and care of the cassette convenient for the 

user. 

On either end of one side of the cassette are two flexible plastic 
tabs called write-protect tabs (see h in Figure 1-2) . latere is one 
tab for each end of the tape? since data should only be written in one 
direction, the user «ill need to be concerned with only the tab 
specifically marked on the cassette label. Depending upon the 
position of this tai> the user is able to protect his tape against 
accidental writing and destruction of data, Vfien the tab is pulled in 
tmi;ard the middle of the cassette so that the hole is uncovered, the 
tape is write- locked; data cannot be written on it and any attempt to 
do so will result in an error isessage, T'Jhen the tab is pushed toward 
the outside of the cassette so that the hole is covered, the tape is 
write-enabled and data can be written onto it. Data can be read from 
the cassette with the tab in either position. 

The bottom of the cassette (B in Figure 1-2) provides an opening where 
the magnetic tape is exposed. The cassette is locked into position on 
a cassette unit drive so that the tape cones in contact with the 
read/write head through this opening. 

Both ends of the magnetic tape in a cassette consist of clear plastic 
leader/trailer tape? this section of the tape is not used for 
information storage purposes, but as a safeguard in handling and 
storing the cassette itself, since magnetic tape is susceptable to 
dust and fingerprints, a cassette should always bo rewound so that the 
leader/trailer tape is the only part of the tape eKposed whenever the 
cassette is not on a drive. 
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Fiqurc 1-2 CAPP-ll Cansetto 



1.2.1 The Fomat of a Cassette 

A cassette is fomatterl so that it consists of a scajnnce of one or 
more filcg. Files on cassette arr; sequential, and each file is 
preceded and follovmd by a file gap. (A qap in this sense ir^ a fixed 
lonath of blank tape.) All cansettes tniiFit start v/ith a file gap; 
information prGcedina the initial file qap is unrcli^^l!e, 

A file consists of a seqitGnce of one or norn data records scparatert 
from one another by a record gap. The records of any cnvnn file must 
follov/ one another in succession, a.i there is no provision for record 
linkip.a. The first rocord of a file is calli^id the headr^r record and 
contains information conccrninq tlie nano of the file, its type, 
Icncrth, and so on. (The Cassette Standard mav bo referenced in 
Appendix P.) There are npprnj:inately 600 records per cassette tape. 
CATS-ll recoqnizes an end-of-file by the presence of either a file gap 
or clear leader following a data record. 

Data records in the CAPS- 11 Systen consist of 12". Cdcclnal) cassette 
bytes; a byte in turn consists of eiaht hits each representinq a 
binary zero or one. Characters and nur-.bers are stored in bytes using 
the standard AfiCII character corses (see Appendix A) and binary 
notation. 

The nuFibor of records of infomation on a cassette tape may be 
estimated hy the user. On the outr^ido of the cassette case is a clear 
plastic windov; (C in Fiqure 1-2). Along the botton of this v/indovj is 
a scries of marhs; each nark rcpr^-sonts aliout 50 inc^hes of maqnetic 
tape. fCnov/inq that approxinately 2 records fit on an inch of tape, 
the user is able to make a reasonable quoss as to the Icnqth of tape 
and nurber of records available for use, T3y simply glancinq at the 
width of the tape reel sh-"rina in the v^in^^o^'J, the user can tell 
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cpiickly if he is very close to the end. Since he is given no advance 
warning of a full tape condition, the user must visually keep track of 
the length of tape he has available. Should the tape became full 
before his file transfer has completetl , another cassette may be 
substituted and the transfer or output operation repeated, or the /O 
overflow option may be used to allot-/ continuous transfer tsee Section 
3.2.4 in Chapter 3). 



1.2.2 The Sentinel Pile 

The last file on a cassette tape is called the sentinel file. This 
file consists of only a 32 {decimal) byte header record and represents 
the logical end-of-tape (CAPS-11 also recognizes clear trailer as 
logical end-of-tape) . A sentinel file is identified by a null 
character (ASCI1=000) as the first nane character in the header 
record. A seroed or blank cassette tape is one consisting of only the 



1.3 TIIE BYSTEll CASSETTE 

The software discussed in f.ection 1.1.2 is provided to the user on a 
single cassette called the Systen Cassette. This is the cassette on 
which the entire CAPS-11 System resides cind which is utilized for all 
normal system functions, l-Jhen in use, the System Cassette should 
always be mounted on drive D (the drive on the left of the TAll 
controller) ; drive serves as the default device when the user fails 
to specify another. 

The write-protect tab on the Systen Cassette should usually be in the 
write-locked position so that data will not accidently be written on 
it; it is suggested that the user make several copies of this cassette 
as protection against loss or accidental destruction. 



1.4 MDOT5TIMG AND DISI'IO'DflTlNG A CASSETTE 

To mount a tape on a drive, hold the tape so that the open part of the 

cassette is to the left and the full reel is at the top. Set the top 

write-protect tab to the desired position depending upon whether data 
is to be written on the tape. 

Open the locking bar on the cassette drive by pushing it to the right, 
away from the drive (see A in Figure 1-3) , Next hold the tape up to 
the cassette drive at appro xirtately a 45-degree angle and insert the 
tape into the drive by applying a leftward pressure while 
simultaneously pushing the cassette onto the drive sprockets. This 
brings the tape Into position against the read/write head. Wien the 
cassette is properly mounted, the locking bar will automatically close 
over the cassette back edge. Figure 1-3 illustrates this procedure. 

Press the rewind button on the cassette unit (see B in Figure 1-3 ^ 
there is a rewind button for each drive). This causes the cassette to 
rewind to the beginning of its leader/trailer tape. (Pressing the 
rewind button a second time causes the cassette to rewind to the end 
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of the iRacler/trailer tape anrl to the physical enri-of-ttipfi. The 
cassette unit will click; thin soiinri is nlr^ost innuriiblo <in(i tho iisfir 
may not hear it unless he ifs listnninn cnrofully, Tlnmnl usncre 
requires tliat the uner preas tlic rev^ind button only once \7henover he 
wishes to rov^inrt a cannottc) . Fvon thnuqh tapes which are not 
actively hcinq used on a driifo should already be positioned at the 
heginnincT, the uRcr should dnvplop the haliit of automatically 
revrindinn a caaaetto. 



Rewindinrx a cmstt&tte is particularly 
inportant since certain functions (such 
as spQCo rnvorne file and space reverse 
blocV:) , initiated on a newly mounted 
cassette prior to the use of any other 
function, could cause the cassette 
controller to function inproperly. Tliis 
condition is renoriied whenever the START 
key is doprensed, or when a hardv/are 
RFISHT instruction is executed. 



\7hcn tlie tape has finished windina, the cnssetto will stop moving. 
The cassette is noi; in place and ready for transfer operations. 




Figure 1-3 Mounting a Cassette 



Before renrving a cassette fron a drive, the tapo should alvMys be 
rev/nund to its bcninnina by pressinn tlie rewind button on the cassette 
unit. Rewindina a tape onnuren thrit the clo.ir loador/trailer tape 
will be the only tapo oxponod at the onon part of the cansethe. To 
rorove a ca'^fictte from the cassotte drivn, opfiin the lockina bar and 
the cassette v/ill pop out, <,'T.uin casacttos are not Jjcing actively used 
on a cassette drive » they can ho stored in the small plastic boxes 
provided for tJiis purpose by the nnnufacturer. 
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rroTE 

Before using a nev? cassette, or prior to 
using a cassette that has just been 
shipped or accidontly dropped, mount the 
cassette on a drive so that the Digital 
label faces the inside of the unit and 
perfom a rov/ind operation. Remove the 
cassette, turn it over, and perfom 
another rov/ind operation. This packs 
the tape neatly in the cassette and 
places the full tape reel at the proper 
tension. 



1.5 CONSOLE OPERATION 

The operation of the conputer console and console terminal, using the 
PDR-ll/lO processor, LA30 DCCi7riter, and LSll line printer as 
examples, folloi/s. 



1.5.1 PDP-11/10 Progrannor's Console 

The PDP-11/10 console is designed to provide convenient manual control 
of the system. Using switches and keys located on the console, 
programs and information can be directly inserted into momory and 
modified. The PDP-11/10 console is sho^jn in Figure I-'!, and each 
switch and key is exnlained in the paragraphs follov^ing the figure. 
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Figure 1-4 The PDP-ll/lO Console 
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Elements of the Console 

The console has the following indicators and switches; 

1. A RUM lanp which, if lit, indicates that the processor 
is running 

2. A 16-bit Address and Data Register display 

3. A 16-bit Switch Register 

4. The following control switches! 

a) l-OAD ADRS 

b) E3a^! 

c) CONT 

d) ENABLE /HALT 

e) START 

f) DEP 

The progrartmer's console has one 16-bit register display used for 
displaying both addresses and data, t-flien displaying the contents of 
the Address Register this display register is tied directly to the 
output of a 16-bit flip-flop register called the Bus Address Register 
and displays the address of any data examined or deposited. It may 
also be used to display the contents of the Data Register by 
displaying data in any wenory location or the results of program 
execution. 

The programmer may reference 16-bit addresses by manipulating the 
Switch Register, A switch in the up position is considered to have a 
1 value; a switch in the 6m-m position is considered to have a 
value. Thus, the address indicated by the switch setting can then be 
loaded into the Address Register or data can be loaded into any raemoary 
location by using the appropriate control switches as follows (when 
the system is executing a progran, the LOAD ADRS, EXAM, and DBPosit 
functions are disabled to prevent any disruption of the running 
progran) : 
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Table 1-1 
PDP-11/10 Control Switches 



Sv-'itch 



Action 



LOAD ADRS 



EXAM 



DRP 



EMABLE/HALT 



START 



COHT 



Transfer the contents of the 16-hit 
Pv-^itch Register into the Address 
Register, 

Display in the 16-hit register 

display the contents of the 

location stored in the Address 
Register. 

Deposit the contents of the 16-bit 
switch Register into the address 
stored in the Address Register, 
[This switch is actuated by raising 
it.) 

Allow or prevent procrram execution. 
To allov/ a proeiran to run, the 
switch must be in the EMABLE 
position {up} , Placing the switch 
in the HALT position (dot-m) will 
halt the system at the end of the 
current instruction, 

Deqin execution of a program (the 
ETJARLE/HALT svritch tnufit be in the 
EHARLE position) . ^Oien the START 
sv;itch is depressed, it asserts a 
systen initialisation signal and 
actually starts the system when it 
is released. The processor v,-ill 
begin execution at the address 
which was last loaded using the 
LOAD ADRR switch. 

Allow the computer to continue 
without initialization from 
whate-^^er state it is in after 
haltinci. 



Operating the Control Switches 

After the processor has halted at the end of an instruction, it is 
possible to examine and update the contents of locations. To exaimine 
a specific location, sot the Si,<?itch Register to correspond to the 
location's address, and press LOAD ADHBr this transfers the contents 
of the Sv?itch Itegister into the Address Register. The location of the 
address to be examined is displayed in the 16-bit register display. 
The user can then depress EXAM, and the data in that location will 
appear in the register display. 
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NOTE 

If the user attempts to examine data 
fron or deposit data into a nonexistent 
menory location, an error will occur and 
the reqister display will reflect the 
contents of location 000004 (the trap 
location for references to nonexistent 
locations), tTo verify that this trap 
has occurred, deposit sore number other 
than four in the location. If four is 
still indicated, either nothinc is 
assigned to that location or vrhats'^er is 
assigned is not working properly. 

By depressing EXA.H again, the Address Register will be incremented by 
two to the next word address, and the contents of this nesit location 
inay be examined, 

The examine function operates such that if LOAD ADBB is depressed and 
then RXAM, the Address Register will not be Incremented. However, 
successive use of the EXIUM switch increnents the Address Hegist^r by 
t*m for each depression. 

If the user finds an incorrect entry in the Data Register, he can 
change it by setting the correct data in the Switch Itegister and 
raising the DEP switch. The Address Register will not increment when 
this data is deposited. Therefore, by pressing the EXAli switch the 
user can examine (verify) the data just deposited. Pressing KXAM a 
second tine will increment the register to the next word address. 

VJhen performing consecutive examines or deposits as previously 
nentioned, the address will increment by t%ro to successi-ye word 
locations. Hov/e\'er, when exanining the general -purpose registers 
(R0-R7}, the system will only increnent by one. 

To start a program after it is loaded into raeitiory, set the starting 
address of the progran in the Switch Register and press K5isn hJ>BS, Be 
sure that the EKABLE/HALT st-fitch Is in the EHRBIM position? depress 
START, The progran should begin executing? as soon as the START? switch 
is released, 

While in the halt raode, the user say execute a single Instruction by 
pressing CONT, t#jen COHT is pressed, the console monentarlly passes 
control to the processor, allos^'ing it to execute one instruction 
before regaining control. Each tine the CONT switch is pressed the 
computer mil execute one instruction. 

To start the progran again, place the ekaSLE/halT sviitch in the ENABLE 
position and press COflT. 



1.5.2 Operating the Console Terminal (LA30 DECwriter) 

The LA30 DEOtflfiter consists of a printer and keyboard, and is 
illustrated in Figure 1-5. 
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Piqurc 1-5 LA30 orCwriter (rierial) 



Thci printer provides a typed copy of input and outpiit at 30 characters 
per Hnconcl, maKinuin. Keyboard functions such as TAB and PPTTiTCt and 
all chnractors, inclurtinq \, I and ], havR a distinct key associated 
with^ then (unlike the LT33 and 15 keyboards which frmrt use key 
conbinationa to produce tliese and other characterf? and functions) . 
The keyboard is illustrated in Ficjure 1-6. 
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Pinure 1-6 IA30 DEO/riter (Serial) Keyboard 



t 



On the back of the T/A3n console atand is a switch which is used to 
turn the teminnl on and off. 'Then the sv/itch is raised, tho rtaDY 
indicator lanp on the keyboard panel licihts to dosimiate that the 
teminal is ready for use. The DECwriter is shut off by pufihinq the 
switch down. 

Rolow the RTADY Innp is a key labeled LOCAL LIflE mFDj while this key 
is pressed, paper is advanced fron the printer. The MODr key next to 
it should bo set to LIHF. for all on-line operations; the baud rate is 
generally fixed at 300 and the DAUri RATE key should he set to this 
fiaure. Randon characters will he qenerated if this key is not sot to 
patch the baud rate. The rer^ainincr keys on the keyboard are used for 
producing typed copy and aro sini lar to those found on a typewriter 
key})oard . 
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A parallel LA30 DKCr/ritcr vnrios in ai^poarnnce sliahtly *"ron a snrial 
LA30 and is pictured in Fiquro 1-7? tha usor does not havn to set a 
nAUD RATH or Li;ir hr-.y ; all othfir oi>crtitinnr; arn the sano. 
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PifTijro 1.-7 T,Mi mTivri tor (T^arallel) 

1.5,3 Opcratinci the LSll I,inG Printer 

The LSll linn printer nay be uncf! to output listincfa at a ratr; of 1G5 
chnractorn per second uith an i^any a<? 132 charnctorg per lino. The 
unit is vnry conpact and can sit on a snail ta]">lo. 
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Finurr- 1-3 L<^11 Lino Printnr 

The operator I'tar.cl in illuatrataf'' i,i FirrurF? 1-0 antT prn-'idf^R the; uFsor 
wiUi the follov/ina fnnctinnn; 
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Table 1-2 
LSll Operator Panel Functions 



Kay 


Action 


Oti/OPP 


Pushing the key ones turns the 

printer on and lights the switch? 
pushina the key a second tirie shuts 
the printer off. 


FELKCT 


Pushing the SELECT key enables the 
printer for use. 


TOP OF porai 


Pushing this key causes the paper 
to advance vertically allowing 

manual form control. 


PORTIS OW.RHIDE 


Pushing this key allows the user to 
conplcte the form being printer! if 
the paper needs to be ' replenished 
(i.e., it overrides a paper-out 
condition) . 


SINGLE LIMK ADVAKCE 


Pushing this key allovj?i the user to 
vertically ffl<3vance the paper by one 
line. 


Indicator 


Heaning 


HAftDWABE ALARM 


Lights to indicate a hardware 




error. 


PAPER OlIT 


Lights to indicate an out-of-paper 

or paper-handling malfunction. 
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Figure 1-9 LSll Operator Panel 
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CHAPTER 2 
PHJGHRMHING TFIE PDP-ll 



l^e PDP-11 processor is a le-bit, general-purpose, parallel-logic 
compttter using two's compleitreiit arithmetic, Progrstmraers can directly 
address 32,768 16-bit words, or 65,536 8-bit bytes. All coittnimi cation 
between system coinpsnents is done on a single high-speed bus called 
the UNIBUS. Standard features of the syatera include eight 
general-purpose registers ^hich can be used as accumulators, index 
registers, or address pointeraj and a multi- level automatic priority 
interrupt system. A simplified block diagram of the PDP-11 System is 
presented in Figure 2-1. 

This chapter gives the PDP-11 programmer an overview of system 
architecture, points out unique hardware features, and presents 
prograrmning concepts basic to its use. asferenoe should also be made 
to the appropriate PDP-11 PIKXTESSOR HWJDBOOK and the PDP-11 
PERIPHIEM-S AHD INTERFACING HAKDBCX)K. 



2*1 GEHERAL SYSTEM StTRUCTURE 

The architecture of a PDiP-ll aysten and the design of its central 
processor prov^idej 

Single and doxible operand addressing 

Full word and byte addressing 

Simplified list and stack processing through auto-address 
stepping (autoincreirtenting and autodecrenenting) 

Eight programmable general-purpose registers 

Data raanipulation directly within external device registers 

Addressing of device registers using normal memory reference 
instructions 

Asynchronous operation of memory, processor and I/O devices 






A hardware interrupt priority structure 
nmlti- level) for peripheral devices 



{multi-line. 



Automatic interrupt identification without device polling 

Cycle stealing direct ineraory access for high-speed data 
transfer devices 

Direct addressing of 32K \«3rds (G4K bytes), including the 4K 

external page 
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Figure 2-1 System Diagram 



Two design features of the central processor serve to increase system 
throughputs 

1. The eight programmable general-purpDse registers within the 
central processor can be used to store data and intermediate 
results during the execution of a s^uence of instructions. 

Register-to-register addressing provides reduced execution 
time for n»03t instructions. 

2. The ability to code to?o addresses within a single instruction 
allows o^rations on data within iBeittory, litis eliminates the 
need to load processor registers prior to data operations » 
and greatly reduces fetch and store operations. 
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2.1.1 Status Register Fojcmat 

The Central Processor Status Register (PS) contains information on the 
current priority of the processor, the result of previous operations, 
and an indicator for detecting the execution of an instruction to be 
trapped during debugging. The priority of the central processor can 
be set under program control ±x> any one of eight levels. This 
information is held in bits 5, 6, and 7 of the PS, Four bits are 
assi^ed to raonitor the results of a previous instruction. These bits 
are set as follows? 



Bit 



Set 



Z — If the result was zero 

N — if ti^e result was negative 

C — if the operation resulted in a 
carry from the most significant bit 

V -- if the operation resulted in an 
arithmetic overflow 

The T bit is used in program debugging and can be set or cleared under 
program control. If this bit is set when an instruction Is fetched 
from meraory, a processor trap will occur at the completion of the 
instruction ' s execution . 
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Figure 2-2 Processor Status Register 



2,1,2 UNIBUS 

The ONIBUS is a key component of the PDP-11 's unique architecture. 
The central processor, raeraory, and all peripheral devices share the 
same bus. This means that device registers can be addressed as 
memory, and data transfers from input to output devices can by-pass 
the processor. No special input/output Instructions exist; all PDP-11 
instructions are available for I/O operations. 



2.1.3 Device Interrupts 

Interrupt request lines provide for device interrupts at processor 
priority levels 4 through ?. Attachments of a device to a specific 

line determines the device •s hardware priority. Since multiple 
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devices can be attached to a specific line, the priority for each is 
determined by position | devices closer to the central processor have 
higher priority. 

Peripheral device interrupts are linked to specific memory locations 
called ^interrupt vectors* in such a way that device polling is 
eliminated, llhen an interrupt occurs, the interrupt vector supplies a 
new Processor Status word (i.e., nev/ contents for the Processor Status 
register) and a new value for the Program Counter, The new PC value 
causes execation to start at the proper handler at the priority lev6l 
indicated by the priority bits of the new Status Register, 



2.1.4 Instruction Set 

The instruction set (explained fully in the PDP-11 PSDCESSOR HANDBOOK 
2ind summarized in Appendix B of this manual) provides operations that 
act upon 8-bit bytes and 16-bit words. Coupled with varying address 
modes CI*alative, Index, Immediate, Register, Auto increment, or 
Autodecrement, each of which can be deferred) asore than 400 unique 
instructions are available. Instruction length is variable {from one 
to three 16-"bit words) depending upon the addressing modeCs) used. 



2,1.5 Addressing 

Every byte has its own unique address. It is the instruction which 
determines whether 8-bit bytes or 16-bit words are being referenced, 
Sords are addressed by their low-order (even-numbered) byte. Although 
byte addressing can be to odd or even numbered addresses, referencing 
words at odd numbered addresses is illegal. Bits are numbered from 
at the lowest-order bit (2<0)) , to 15 (for a word) or 7 (for a byte) 
at the highest-order bit (2(15) or 2(73). 

Most data in programs is structured in some way, often by means of 
tables consisting of the data itself or of addresses which point to 
the data. The PDP-11 handles ccmonon data structures with operand 
addressing modes specifically designed for each )cind of access. In 
addition, a&Jressing for imstructured data peirmits direct random 
access to all of merriory. The actual formats of the nodes are 
described in Chapter 5, concerning the Asseiabler* 



Registers 

Addressing in the PDP-11 is done through the general registers. These 
registers cem be specified by preceding a number in the range to 7 
by a % sign. However, it is common practice to assign register 

identities to symbols i often RO=%G, R1='%1, etc. (see Chapter 5, 
Section 5.4.4), Throughout this manual, reference to M, Rl,,.,R7, as 
well as to SP and PC, assumes such prior direct assignment* All eight 
general registers are accessible to the programmer, but two of these 
have additional specialized functions? M is the processor Stack 
Pointer (SP) , and R7 is the Program Counter (PC), Both are discussed 
in more detail later in this chapter. 
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To make use of a register as an accumulator, inde:c register, or 
sequential address pointer, data needs to be transferable to and from 
the register. This is accomplished using Register Mode, which 
specifies that the instruction is to operate on the contents of the 
indicated register itself. For example: 



CLR R3 



» CLEAR REGISTER 3 OF ITS CONTEi^tTS 



Address Pointers 

The instruction can be made to interpret the register contents as the 
address of the data to be operated on by specifying that Register Mode 
be deferred. For example, if register 3 contains 1000, either 
instruction: 

CLR «R3 

CLR (R3) 

will clear the address 1000. Moreover, if it is desired to perform 
the instruction successively upon data at sequential addresses (i.e., 
in a table) , Autoincrement Mode can be selected. This will 
automatically increment the contents of the register after its use as 
a pointer to the next sequential byte or word address. Note that 
Autoincrement Mode (as well as Autodecrement Mode) is automatically 
deferred one level to cause the register contents to function as a 
pointer. 

When it is specified that Autoincrement Mode be deferred, it is 
deferred two levels so that the instruction interprets the 
autoincremented sequential locations as a table of addresses rather 
than as a table of data, as in nondef erred Autoincrement Mode. The 
instruction then operates upon the data at the addresses specified by 
the table entries. 

Each execution of each of the following ADD instructions increments 
the value of the register contents by two to the next word address 
(always an even number) . 



ACCUMs ADD CRe)+,CRn + 



J>1P ACCUM 



iir R0 INITIALLY CONTAIMS 1000 
iAND Rl INITIALLY CONTAINS 1450, 
J THE VALUES AT LOCATIONS 1000, 
il002* ETC., ARE ADDED TO THOSE AT 
^LOCATIONS M50, IA52. ETC., AND 
iTHE RESULT STORED AT 1450, ETC 



ACCUM: ADD t(R3)+,R2 



jyiP ACCUM 



JIF R3 INITIALLY CONTAINS 1000 
J AND LOCATION 1000 CONTAINS 3420, 
J THE VALUE AT LOCATION 3420 IS 
J ADDED TO THE CONTENTS OF R2 AND 
iTHE RESULT IS STORED THERE. AT 
iTHE NEXT EXECUTION OF THE 
JINSTRUCTI ON, R3= 1002. 
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Byte instructions such as TSTB (iEt2) + 
increment the register contents by one. 



(using Autoincrement Itode) 



In addition to this capability of increiRenting a register's contents 
after their use as a pointer, an address mode complementary to this 
exists. Autodecrement Mode decrements the contents of the specified 
register before the contents are used as a pointer. This mode, too, 
can be deferred an additional level if the table contains addresses 
rather than data. 



Stack Operations 

Both Autoincrement and Autodecrement Modes are used in stack 
operations, stacks, also called push-down or last-in- first-out lists, 
are important for temporarily saving values which might otherwise be 
altered. Their characteristic is that the most recent piece of data 
saved is the first to be restored. The PDP-11 processor makes use of 
stack structure to save and restore the state of the machine on 
interrupts, traps, and subroutines. To save, data is "pusheMS" onto a 
stack by autodecretnenting the contents of a register (e.g., WOV 
iO,-Clt6))! to restore, data is •popped" from a stack by 
autoincretnenting (e.g., MOV (R6) + ,H3>, The register being used as tha 
Stack Pointer always points to the top word of the stack. 



MEMORY 



1. AN EMPTY 
STACK 



£0 



2, PUSHING A 
DATUM ONTO 

THE STACK 



El 



EO 



3. PUSHiNG ANOTHES 
DATUM ONTO THE 
STACK 



12 



z. 



El 



EO 



4, ANOTHER 

PUSH 



El 



EO 



5 POP 



13 

z. 



El 



EO 



6- PUSH 



El 



EO 



Z POP 



Figure 2-3 Illustration of Push and Pop Operations 



ReindQin Access of Tables 

Direct access to an entry in the middle of a stack, or in any kind of 
table, is accomplished through Index Mode. The contents of a register 
are added to a base (fetched from the word or secoiuJ word following 
the instructicm) to calculate an aASress. with this facility a 
fixed-order element of several tables, or several eletr^nts of a single 
table, may be accessed. 
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TABLl: 



Table of Words Addresses 
of entries 


if R3 

contains J 


Operand code iss 








1 


*TBL1 

^flLl+4 
■^BLl+6 
-KPBLl+10 


^ 

2 

4 

6 










TBLl(R3) In 




I each case 




10 


• 
• 


* 

.J 





When deferred Index Mode is specified <i,e., §TBLl{R3}), the 
calculated address contains a pointer to the data, rather than 
containing the data itself. Byte tables are discussed in Section 2,2, 



Address Modes 

Addressing modes may be sunnariaed as follows and are discussed in 

detail in Chapter 5, 



Addressing Modes 



Non-deferred Modes 


Assembler 

Syntax 


Mode ; Typical Use 


Rn 


Regis-ter 


Acctunulator 


(ln] + 


flu to increment 


Sequential pointer to data in 
a table 1 popping data off a 
stack 


-(Rn) 


Autodecrement 


Sequential pointer to data in 
a table; pushing data on a 

stack 


A(Rn] 


Index 


Handom access to stack or 
table entry 




Deferred Modes 


Assembler 
Syntax 


Mode 


Typical Use 


§Kn or (Rn) 


E>ef erred 
Register 


Pointer to an address 



(Continued on next page| 
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Table 2-1 iCont. ) 

Addressing Modes 



Assembler 
Syntax 


Mode 


Typical Use 




Deferred 

Au t o in cremen t 

Deferred 

Au t ode creme n t 

Deferred Index 


Sequential pointer to ad- 
dresses in a table; popping 
address pointers off a stack 

Sequential pointer to ad- 
dresses in a table J pushing 

address pointers on a stack 

Random access to table of 
address pointers 



Accessing Unstructured Data 

Addressing of unstructured data becomes greatly facilitated through 
the use of the Program Counter (R7) as the specified register in these 
modes. This is particularly true of Autoincrement and Index Jtodes, 
which are mentioned below, but discussed more fully in Chapter 5. 

Autoincrement Mode using R7 is the way immediate data is assembled. 
This mode causes the operand itself to be fetched from the word (or 
second word) following the instruction. It is designated by preceding 
a numeric or symbolic value with #, and is known as immediate Mode, 
The instruction: 

ADD #50* R3 

causes the value 50 (octal) to be added to the contents of register 3, 

If the # is preceded by 9, the iirmediate data is interpreted as an 
absolute address; i.e., an address that remains constant no matter 
where in memory the asseinbled instruction is executed. 

Index Mode using R7 is the normal way i«#mery addresses are assembled. 
This is relative addressing because the nuntf>er of byte locations 
between the Program Counter (which contains the address of the current 
word-«-2) and the data referenced (destination address minus PC) is 
placed in the word (or second word) following the instruction. It is 
this value that is indexed by R7"the Program Counter— as follows! 

(Destination-PC) 4-PC=Destination 

Relative Mode is designated by specifying a roemory location either 
numerically or symbolically (e.g., TST 100 or TST A). If a msmory 
address specification is preceded by Q, it is in deferred Relative 
Mode and the contents of the location are interpreted by the 
instruction as a pointer to the address of the data. 
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2.2 INSTROCTION CAPABILITY 

The twelve ways of specifying an operand demonstrate the flexibility 
of the PDP-11 in accessing data according to how it is structured, and 
even if it is not structured. Each instruction adds to this 
versatility by acting on an operand in a way |sarticularly suited to 
its task. For example, the task of adding, moving, or comparing 
implies the use of two opersmds in any of the twelve addressing forms? 
whereas the task of clearing, testing, or negating implies only one 
of^rand, Exaraplesj 

ADO #|g*GR0UP<R2> 
MOV H£MI*MEH2 
mP <R4) + / VALUE 
CLR R3 

TST SUM 
MEG 9-tR5> 

Scxne instructions have counterparts which operate on byte data rather 
than on full words. These byte instructions are easily recognized by 
the suffixing of the letter B to the word instruction. MOV is one 
such word instructioni e.g., MOVE il2,GWDUP(R2) would move an 8-bit 
value of 12 foetal) to the 8-bit byte at the address specified. One 
implication of byte instructions is that when using Autoincrement or 
jfiutodecrement Mode, a table of bytes is being scanned. The 
Autoincrement or Autodecrement therefore goes by one in byte 
instructions, rather than by two. However, because of their 
specialized processor functions, R6 and r7 in these modes always 
increment or decrement by two. 

Forms other than single or double operand instructions include operate 
instructions such as HALT and KESlf which take no operands, branch 
instructions which transfer program control under specified conditions 
(see Chapter 5), subroutine calls and returns, and trap instructions 
jsee Appendix B for the complete instruction setj* 



2.3 PRDCESSOK OSE OF STACKS 

Because of the nature of last-in-first-out data structures, the sajtie 
stack can be used to nest multiple levels of interrupts, traps, and 
subroutines (see Figure 2-4) . 



2,3,1 Subroutines 

In subroutine calls (JSR Register, Itestination} the contents of the 
specified register are saved on the stack (the processor always uses 
R6 as its Stack Pointer) and the value of the PC (return address 
following subroutine execution) becomes the new value of the register. 
This allows any arguments following the call to be referenced via the 
register. The command RTS Register causes the return from the 
subroutine by moving the register value into the PC. It then pops the 
saved register contents back into the register, (Return from a 
subroutine is made through the saute register that was used in its 
call,} 
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2.3.2 Interrupts 

When the processor acknowledges a device interrupt request, the device 
sends an interrupt vector address to the processor. The processor 
then pushes the current Status (PS) and PC onto the stack and picks up 
a new PS and PC (the interrupt vector) from the address specified by 
the device. /Jiother acknowledged interrupt before dismissal -will 
cause the PS and PC of the running device service routine to be pushed 
onto the stack and the address and status of the new service routine 
to be loaded into the PC and PS, A process can be restaned by popping 
the old IC and PS frcro the stack into the current PC and PS with the 
IfeTurn frcsn Interrupt (KTI) instruction. 



2.3,3 Traps 

Traps are processor generated interrupts. Error conditions, certain 
instructions, and the cornpletion of an instruction fetched while the T 
bit was set all cause traps. As in interrupts, the current PC and 
Status are saved on the stack and a new PC and Status are loaded from 
the appropriate trap vector. The instruction RTI provides for a 
return from an interrupt or trap by popping the top two words of the 
stack back into the PC and PS. 
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Figure 2-4 Nested Device Servicing 
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CHAPTER 3 
USING THE CAPS-11 MONITOR 



The Cassette Prograraming System is stored on m single cassette, called 
the System Cassette, which ccmtains all the prograiBS necessary for 
loading the Keyboard Moaifcor into iresmory and creating and running 
system and user programs. (The System Cassette sullied to the user 
is configured for an 8K system, Refer to Appendix E for instructions 
concerning building a System Cassette for any sisse configuration.) The 
directory of the Syst^ Cassette is as follows: 



CTLom 


srs 


CAPSl 1 


SSK 


PIP 


SRU 


EDIT 


Si.6 


LINK 


SRU 


ODT 


SLG 


PPL 


SRU 


OiMO 


PAL 



The Monitor is loaded into memory from the System Cassette by means of 
a short bootstrap program. Once in memory, the Monitor accepts 

corwaands from the console terminal keyboard which allow the user to 
run system and user programs, and create, asserrtsle, load, execute, and 
debug programs, utilizing cassettes for all data storage. 



3,1 LOADING IMSTROCTIOHS 

fflie first operation in using the CAPS-11 System involves loading the 

Monitor into mamory frcmi the System Cassette. The loading process may 
be acccraplished by following steps 1 through 4 below j 

1. Ensure that the computer and console terminal are 
<Hj~line, 

2. Place the Systen Cassette (write- locked to protect data) 
onto cassette drive (facing the computer, drive is 
to the left of the cassette unit) , 

3. Press and raise the HALT key (leaving it in the ENABLE 
position) , 
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4. Load and gtart the system bootstrap loader {called 
CBOOT) . This can be done in one of two wayss 

a) If the system has a hardware bootstrap, set 17330Q 
in the Switch Register, press MiM> hBJiS and START 
(part b jruay be ignored) , 

b) If no hardware bootstrap is available, CBOOT must be 
manually loaded and started by the user. Two 
versions of CBOOT are provided. The standard 
version is the version used in the hardware 
bootstrap and consists of the 2 8 words listed in 
Table 3-1. A complete listing and more information 
concerning CBOOT is provided in Appendix E. 

A shorter (20 word) irarsion called QCBOOT may 
optionally be loaded by the user. This version does 
not provide seme of the error checking and handling 
which the longer CBOOT does, but allcsws a faster 
means of manual ly booting the system. A cra^iplete 
listing of OCBOCKP is also provided in Appendix Ej 
the binary instructions are listed in the following 
table: 



Table 3-1 
CBOOT (QCBOOT) Instructions 





CBOOT 


QCBOOT 


Location 


Contents 


Contents 


001000 


012700 


012700 


00X002 


1775Q0 


177500 


001004 


005010 


005010 


001006 


010701 


010701 


OOIOIO 


0627Q1 


062701 


001012 


000D52 


000034 


001014 


012702 


112102 


001016 


000375 


112110 


001020 


112103 


032710 


001022 


112110 


100240 


001024 


100413 


001775 


001026 


130310 


IQOOOl 


001030 


001776 


005007 


001032 


105202 


005202 


001034 


100772 


100770 


001036 


116012 


116012 


001040 


000002 


000002 


001042 


120337 


000766 


001044 


000000 


017775 


001046 


001767 


002415 


001050 


oooooo 




001052 


000755 




001054 


005710 




001056 


100774 




001060 


005007 




001062 


017640 




001064 


002415 




001066 


112024 
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After the bootstrap has been manually loaded {using 
the Switch Register, LOAD ADRS , and DEP keys), set 
001000 in the switches, press LOAD ADRS and START. 

At this point the RUN lamp should be lit and the System Casssette 
should begin to itiove. The bootstrap loader {CBOOT or QCROOT) calls 
the first program on the System Cassette (CTLOAD.SYS) which in turn 
loads the Keyboard Monitor (CAPSll.SYS) into memory , If an error 
occurs during the loading process (an error may be caused by the 
cassette being improperly mounted, by a missing file on the tape, or 
by the occurrence of an I/O error) no error message will inform the 
user. Instead, the System Cassette may stop moving and the coniputer 
will halt. If this condition occurs and the reason for the halt is 
not immediately apparent, consult Appendix E, which provides more 
information concerning errors during the loading process. 

Once the fksnitor has been loaded, the System Cassette stops moving and 
a dot is typed at the left margin of the console terminal page. A 
Monitor identification line may also be typed; however, this line will 
be output only if the Monitor is being loaded for the first tine, or 
if a previously loaded CAPS-11 sy5?tem has been completely deleted from 
memory. The total time involved in the loading process (i.e., from 
the bootstrap initialization on a rewound cassette to the appearance 
of the dot) is approximately 30 seconds. The dot instructs the user 
that the Monitor is now in memory and ready to accept input commands. 



3.2 SYSTEM (JpNVENTIONS 

File naming procedures, special character commands, error formats, and 
other conventions which are standard for the CAPS-11 System are 
presented next. The user should be familiar with these conventions 
before using the system. 



3.2.1 File Formats 

The Cassette Programming System makes use of two types of file 
formats — ASCII and binary. 

Files in ASCII format conform to the American National Standard Code 
for Information Interchange in which alphanumeric characters are 
represented by an 8-bit code. A chart containing ASCII character 
codes is provided in Appendix A, Files in ASCII format are generally 
those created using the Editor. 

Files in binary format consist of 8-bit bytes representing data and 
PDP-11 machine language code. Binary files contain addresses and 
machine instructions and may be read directly into memory for 
immediate execution. System programs eind object programs the user has 
created using the Assembler and Linker are in binary format. 
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3.2,2 Input/Output Devices 

There are four categories of input/output devices in the CM*S-11 
System; these are the console terminal keyboard and printer, cassette 
drives and 1, an optional line printer, and an optional high-speed 
paper tape reader and punch (which may be used only by PIP as 
discussed in chapter 8) . Each device is referenced by means of a 
standard permanent device name which is recognized by the CAPS-11 
System when encountered in an I/O command string. These names are 
listed in Table 3-2: 



Table 3-2 
Permanent Device Names 



Name 


Device 


CTO {or 0) 


Cassette Drive 


CTl Cor 1) 


Cassette Drive 1 


pp 


High-speed Paper Tape 
Punch 


PR 


High-speed Paper Tape 
Beader 


1^ 


Line Printer (LPll or 
LSll) 


TT 


Console Terminal (Lf33 
or LTSS Teletype, VT05 
Display, or XA30 
DECwriter) 



3,2.3 Filenames and Extensions 

System and user files are referenced symbolically by a name of as many 
as six alphabetic characters CA-Z) or digits (0-9) , followed by a 

period and an optional extension of frc»n 1 to 3 alphabetic characters 
or digits f the extension is generally used as an aid in remembering 
the format of a file. The following are examples of legal and illegal 

filenames ; 



Ijegal 



Illegal 



ITYPE.PAL 

ABCDEF.OBJ 
DATA. 

PH0.21R 

FILE (extension assumed) 



g STOW, PAL 
PO HM 

PROGI^M.DAT 
UiKD, 34AN 



Although the user may call his files by any mnemonic filenajae and 
extension he chooses, in most cases, he will want to conform to the 
standard extensions established for CM>S-11 and listed In Table 3-3, 
There are two reasons why the standard extensions should be uaedt 
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a) If an extension is not specified for an input file (for 
example, F11*E in the preceding list of legal 
filenames) , certain system programs and Monitor 
coBBtands will perform a search for tlie filename and an 
assumed default extension; the Monitor HtFN command is 
on* example of a system routine which assumes an 
extension if no other is indicated, 

b) If an extension is not specified for an output file, 
some system programs will append standard extensions 
during the output operation; for example, the Assembler 
will append the extension .LST for the output listing 
file unless the user designates another. 

Standard extensions savB the user tine in typing the command line imd 
provide consistency in filen^ning procedures; the folls*?ing table 
lists the default extensions; greater detail is presented in the 
individual chapters. 



Table 3-3 
CAPS- 11 Default Extensions 



Extension 


Jfeaning 


.LDA 


Linker binary output load module 


.LST 


Assen^ler listing output file 


.MAP 


Linker load map output 


,OBJ 


Relocatable binary object module 

(Assembler output, Linker input) 


.PAL 


Assembler source file (Editor input and 
output, Assembler input) 




HOTE 




The next three extensions are 
4fefault extensions for the 
Monitor RUN coirasand. See 
Section 3.3.1 for details. 


.SLO 


Absolute binary object file (default 

extension for RUM command, causing an 
automatic load and overlay of the 
Monitor as necessary up to CABLDR) 


.SLG 


Absolute binary object file (default 

extension for RUN coRinand, causing an 
autoiftatic Load and Go) 


♦ SRU 


Absolute binary object file (normal 
default extension for the RtM command) 


.SYS 


I CAPS-11 system file (i.e., CTLOAD.SYS, 

j CTiPSll.SYS? the extension is reserved 




for these two files) 
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3.2.4 Entering I/O Infoirtnation 

As soon as the Monitor has been completely loaded into memory^ it 
responds by printing a dot (.) at the left margin of the console 
terminal page indicating that it is ready to accept a command from the 
user. A part of the Monitor called the Keyboard Listener (KBL) is 
responsible for printing the dot. There are eight coiFstnands which the 
user may type in response to this dots DATE, EEBO, SEHTINEL, 
DIRECTORY, RUN, LOAD, STAOT, and VERSION. Ttie KBl, interprets these 
comitiands and in most cases executes themj however, since the Monitor 
RU^ coiMfiand requires more information froBi the user, another important 
part of the Monitor— the Command string Interpreter— -must be involved. 

The Coiranand String Interpreter (CRI] allows the user to enter command 
strings which provide necessary information concerning input and 
output files and devices, file formats to be used in I/O operations, 
and any other important information needed for the I/O process. The 
CSI prints an asterisk (*) at the left margin of the console terminal 
page as soon as it is ready to accept this information. 

NOTE 

The user may enter his I/O command 
string as soon as the asterisk is 
printed even though program loading (as 

a result of using the RUN command) may 

be occurring at the same time. The user 
should be careful not to manually rewind 
or dismount the System Cassette while 
loading is continuing. After loading is 

complete, the System Cassette will 
automatically rewind. 

The command string which the user enters in response to the asterisk 
contains all input and output specifications in the following general 
format! 

*DEV ! OUTPUT , EXT/OPTnDEV s INPOT , EXT /OPT 

DEV represents one of the permanent device names listed In Table 3-1, 
If a cassette is the device, only the drive number need be entered 
separated from the filename by a colon, OUTPUT. EXf and IMPOT.BXT 
represent filenames and extensions, as explained in Section 3.2,3. 
/OPT represents an option letter from the list described briefly in 
Table 3-4. Options are separated from the rest of the ccsnmand line 
and from one another by a slash character (/) and are indicated in the 
command string only when the user wishes the associated action to 
occur. Option usage varies according to the program being used? refer 
to individual chapters to learn which options are used by each CAPS-ll 
system program. 
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Table 3-4 
CSI Options 



Option 



Meaning 



/A 
/B;n 

/C 

/D 
/P 






/P 



ASCII! the file type is set to ASCII Cuaed during 
a PIP file transfer) . 



Bottom r links the user program 
location at n {used by Linker) , 



with its lowest 



Continuation; indicates that the command string is 
to be broken into one or more lines. The /C 
option must be used at the end of each line that 
is to be continued. 

Delete; indicates file deletion (used by PiP) , 

Forward,- indicates that the cassette need not be 
rewound before searching for the file (i.e., the 
filename preceding the option is in a forward 
direction in regard to the tape's current position 
on the drive). The RUN coiranand assuites this 
option. 



High? links the user program with 
location at n (used by the Linker). 



its highest 



Overflow! used after an output filename, 
indicating that the file preceding the option is 
to be created and used only for output oi^erflow 

conditions. if no filename is Indicated ^ the 
overflow file will be created under the same naine 
as the most recently opened output file. 

Prompt; requests that the system prompt the user 
to change cassettes on an indicated drive before 
attempting to access a file. The system prints: 



/s 



/T 



/Z 



#? 



where # represents the number of 

drive . 



the appropriate 



Se^|«ral; used after a Linker input filename to 
indicate that this filename contains more than one 
input object module. (Several object modules may 
be combined under one filenaire using PIP.) 

Transfer address; used after a Linker input 
filename (object nodule) to indicate that the 
transfer address of this object module is to be 
used as the transfer address of the final load 
module » 



Extended? suppresses extended binary output in 
assembly listing (used by PM.) . 



an 



Zero; causes all output cassettes indicated in the 
command line to be zeroed, or completely deleted 
of files (used by PIP) . 
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The general form of the command line as shown previously consisted of 
only one input and one output file indicated on a single line. 
However > from to an unlimited nunber of filenames may be entered 
depending upon the system progran in use , and the command string can 
be broken into two or more lines by using the special option character 
/C. A separator always divides the input specifications from the 
output specifications and may be any one of the following! 

= equal sign 

< left angle bracket 

^ back arrow 

The user may orait indicating a permanent device name entirely in a 
ccrtmand string if he is aware of how his coinraand line will be 
interpreted by the Monitor. Consider the following coiwnand string* 

*CT0J FIRSr. PAL.>LPt = Cri:TAS<» U CTlS TAS4. 2* CTBf TASK - 3/0 
>CT0t TASK.-<I 

This command string contains two 'lists* of device designations — the 
output 'list' contains CTO and LP; the input 'list' is made up of CTl, 
CTl, CTO, and CTO. Unless the user designates otherwise, the Monitor 
will always assume that the firsit device in any 'list* (input or 
output) is cassette drive 0; all immediately following default 
(unnamed) devices in this 'list' will also refer to drive 0. This 
continues until the user specifies a different device using a 
permanent device name from Table 3-2. Thereafter, all iinmediate 
default devices will reflect the most recent user- indicated device. 
If the first device in a 'list' is not drive (i.e., the user has 
specified another permanent device name as in the input 'list' above), 
all default devices -will reflect this user- indicated device until a 
different device is specified, and so on. Thus^ the above eosmand 
line could have been written t 



• Fl RST. PAL, LPs = n TASK . 1 , TASK, 2, 0t TASK . 3* TASK . A 



The Command string Interpreter scans the user's coKonand string and 
constructs a table containing all the input and output information 
which has been entered. Details concerning this table and more 
information regarding both the KBL and CSI is provided later in the 
chapter and in Appendix E, 



3.2.5 Special Characters and Comimands 

The following special characters and coirmands can be used by the 
programmer to control execution and correct command lines; these 
commands may be used while under control of any of the system 

programs. 
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Table 3-5 
Special Characters /Commands 



Character/CoBUBancl 



Meaning 



CTRL/C 



CTKL/0 



Control can be returned to the Keyboard 

Itonitor while running any of the system 
programs by typing a CT8L/C (produced by 
holding down the CTRL key and simultaneously 
pressing the C key). A CTRL/C causes a 
complete rebootstrap (if necessary) of the 
Ifeyboard Itonitor by reading the appropriate 
files from the System Cassette on drive 0. 
The system prints : 

iC? 

which prompts tte user to mouint the System 
Cassette on dri-^^ (in the event that it may 
not already be aiotinted) j typing any character 
will continue execution of the reboot. If 
the Monitor is still intact in memory, no 
reboot is necessary and typing a CTRL/C will 
echo only ^C and cause an iiwjediate return to 
the KBL. When it is ready to accept input, 
the KBL types a dot at the left inargrin of the 
teleprinter page. 

Teleprinter output can be surpressed by 
typing a CETXL/0 (produced by holding down the 
CTRL key and aiwultaneovssly pressing the 
key) . This allows execution of the program 
to continue but stops all console printout. 
Typing a second CTRL/0 will resume printout 
again. Unless output is extremely lengthy, 
or unless the program is waiting for input 
from the user^ processing of a program after 
an initial CTRL/0 has been typed will usually 
be completed before the user is able to type 
a second CTKL/0. Printout will automatically 
jffisujne Mhen control is returned to the 
lifeyboard Listener (indicated by a dot at the 
left margin) . 

KOTl 

CTHL/0 does not suppress line 
printer output, and does not 
prevent certain important error 
messages from printing on the 
console terminal. 

CTRL/0 is treated somewhat 

differently when using the CaPS~ll 
Linker to produce a load map. 
Refer to Chapter 6 for details. 



tContini^d on next page) 
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Table 3-5 (Cont.) 
Special diaracters/CoBvmands 



Character/Conmand 



^5eanincf 



CTRL/P 



CTKL/U 



RUBOUT 



h CTRL/P (produced ty typing the CTRL and P 
keys simultaneously) during the initiating of 
a Monitor command echoes ^P and causes 
control to return to the Keyboard Listener, 
indicated by a dot at the left margin. 

A CTRL/P typed during the initiating of a CSI 
command string echoes fP and causes a 
re-initialization of the Coiamand String 

Interpreter, indicated by an asteris>c at the 
left margin, 

E>uring execution of a user prograrii, a restart 

address may have been specified by the user 
within his program so that a CTRL/P will 
cause a restart of that program rather than 
of the Monitor. Refer to the CTRL/P RESTART 
lOT (Chapter 9, Section 9.4.1) for details, 

A line currently being entered (whether as 
part of a cc«nmand or as text) may be ignored 
by typing a CTRL/U {produced by typing the 
CTRL and U keys simultaneously). A +U is 
ech<^d followed by a carriage return/line 
feed (when using the Editor, an asterisk is 
also printed) f the user may enter a new line. 
(This conmand produces the same results as 
typing RUBOOT's back to the beginning of a 
line . ) 

A ROBOUT (produced by pressing the MUBOUT 
key) causes a deletion of the most recently 
typed character emd echoes the deleted 
character on the terminal. Each successive 
RUBOUT deletes and echoes one nKsre character 
{up to the preceding carriage return/line 
feed, after which successive RUBOUTs will not 
echo nor delete any characters) . 



3,2,6 Error Message Format 

Error n^ssages are printed whenever the Keyboard Monitor is used 
Incorrectly, or yAien an I/O error occurs while using Itonitor commands 
and system programs, or upon occurrence of a hardware error. The 
appropriate message is printed on the console terminal at the time the 
error occurs? the message is preceeded by either a question mark or a 
percent sign to indicate one of the following t 
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% Fatal error; execution of the command cannot 
be continv^d further and control returns to 
the KBL, A dot is printed at the laft margin 
of the teleprinter page when the Monitor is 
ready to accept another command. 

? Non~ fatal error; if possible, execution of 
the command will continue after the error 
message is printed on the console terminal r 
if further execution is not possible, control 
will return to the CSI and the user may enter 
another command string. 

A list of Monitor error Btessages is provided in Section 3.7, 



3.3 KECTOARD MONITOR COMMANDS 

There are eight Keyboard Monitor comnands which aay be typed in 
response to the dot printed by the Keyboard Listenerj they are entered 
when the HETURN key ia pressed. Any error made while utilizing these 
commands will result in a message informing the user. After 
occurrence of an error, control returns to the KBL and the coFimand 
najst be retyped. Monitor coflwnands generally require only a single 
cofiwnand line which specifies the device, filename (s) , and switch fes) 
in the following formats 

.CX)KMAND/SW mVfFl LENA. EXT 

CO^MAND represents one of the eight Monitor ccininands. SW represents a 
switch-^Ein alphabetic character separated from the command and from 
another switch character by a slash {/) i switches are similar to the 
CSX options discussed in Section 3.2.4, but perfonn different 
functions and are valid only when used with Monitor commands j switches 
are discussed individually in sections concerning the comnands with 
which they are used. The device (DEV) ^ if specified, will always be a 
cassette, so the user may enl^r only the drive nunfcer rather than the 
entire permanent device name if he wishes, with the exception of the 
ZEBO coranand, drive is always assumed, so the user may canit the 
device specification entirely if CTO is the device. FILENA,E:sr 
represents the file being accessed? the filename must be separated 
from the drive nuirfber £if indicated) by a colon. 

lliroughout this section, optional entries in the command lino are 
enclosed in square brackets. 



3.3,1 RUN Ccmmand 

The RUN command ia of the form: 

.R[UN1 [ICP]#j1PILENA[.EXT] 

The RUN command instructs the Monitor to load and execute the file 
specified in the command line; this file must be in absolute binary 
format. If the user omits the extension (as is generally the case 
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when calling system programs) , the Monitor will search the indicated 
cassette for the file as the user has designated it in the comtnand 
line. However, it assuiiKs that it will find the filename followed by 
one of three extensions: .SLO, ,SLG, or .SJaJj the first file found 
which has the indicated filename and one of these extensions will be 
accessed. 

The extensions used by the RUN corunand are interpreted as follows: 

,SLO The file is an absolute binary object file and 
will be loaded into B«inory overlaying as necessary 
all parts of the Monitor as far as CABLDR {see 
Section 3.5)? after the file is loaded, it is 
automatically started, RUNning a file with this 
extension is identical to a LOAD/0 of the file. 
Presently, no system programs use the .SLO 
extension; howe^r, it is available for future 
system expansion and for general use, 

.SLG The file is an absolute binary object file and 
will be loaded into memory to the bottom location 
of CLODll (see Section 3,5) . Execution is 
automatic. System programs which use this 
extension are EDIT, SLG and ODT.SLG, tfsing this 
extension is the sarie as using the /G switch with 
the LOAD command, 

,SRU The file is an absolute binary object file and 
will be loaded into memory and automatically 
started, "Eiis is the normal default extension for 
the RUN command and is used by the following 
system programsj PIF.SRU, PAX.SRir,, LINK.SRU, 
Using this extension is similar to using the LOAD 
copmand except that execution is automatic and 
more I/O information must be provided by the user, 
thus involving the CSI. 

For example, assume the directory of cassette drive 1 is as follows j 

TABLE 1 

FORM SRU 

FI ELD PAL 

FOF(M SLG 

If the user types : 

^n UFORMI 

The cassette on drive 1 will be searched for the first file consisting 

of the name FORM and one of the three extensions? in this case the 
first file meeting these requirements is FOHM.SRU. This file Is 
loaded into memory and executed. After the file is loaded i the 
cassette is automatically rewound^ thus, if the user wishes to access 
the file FORM. SLG, he must either delete the file FORM. SRU from the 
cassette (see Chapter 8) , or specify the entire filename In the 
command line as follows » 

.R l!FORM.a.G 
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If a user program with no specified transfer address is loaded via 
RUN I the fatal error messaqe: 

mo START ADOR 

will be printed. If the file indicated in the command line is not 
present on the cassette, the fatal error message t 

XHLE NOT FNO 

will be printed, 

3.3.2 LOAD Conimand 

fhe LOAD ccHtraand is used to load an absolute binary file into mewoiy 
and takes the following formj 

.LlOADj [/SWl f fCTjfilFlLENA.EXT 

/SW represents either a /O or /G switch. If neither switch is 
indicated in the cammand line^ the command allows loading only to the 
bottom location of the KBL without error {see Figure 3-1 in Section 
3.4). At the completion of the load, the KBL prints a dot to indicate 
that it is still intact and ready to receive another Monitor coimnand 
(typically either START or another LOAD) . 

LOAD used with a /G switch directs a program load to the bottom 
location of CLODll, and then initiates a •GO' fBTART? at the specified 
transfer address. If this is absent, the fatal error messages 

SMO START mon 

tC? 

will be printed, since the KBL and CEI are 'marked' (or assumed} as 
being overwritten when the /G switch is used, the Monitor must be 
rebooted from the System Cassette on drive Q. 

LOAD used with a /O switch allows a program to be loaded even if its 
size requires overwriting the entire Monitor, Such a program must 
handle its own I/O and other functions since no part of the Monitor 
may be available to do this. This type of program is started at its 
transfer address; if none has been indicated, CABLDE will halt and 
expect user console action (information concerning a CABLDR halt is 
provided in Appendix E) , 

Section 3.5 provides greater detail concerning the loading process 
when RUN or any form of the 1(0AD canaaand is used. 



3.3.3 START Command 

The START command is of the formi 

, ST [ART] [nnnnnnj 
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and is used to start a program which has been loaded into memory using 
the LOAD command without a switch, nnnnnn is an optional absolute 
starting address for the program, and if indicated, will cause program 
control to be transferred to this address. If not indicated, the last 
specified transfer address of the program [s) loaded will be used. If 
no transfer address exists, an error message is printed and control 
returns to the KBL, 

For example, the program LDT.SLG on cassette drive 1 is loaded and 
started at location 1000 as follows: 

.LOAD ItLDT.SLG 
.ST 1000 

3.3.4 DhTE Command 

The DATE command is of the form: 

. DA [TE] dd-mmm-yy 

where dd, ntnm, and yy represent the current day, month, and year as 
entered by the user. One- or two~digit nuirtbers in the range 1-31 are 
entered in the day portion; the first 3 characters of the rsonth are 
entered in the month portion of the comnand; digits in the range 0-99 
are entered in the year portion. The Keyboard Monitor checks for the 
entry of a number which is outside the ranges allowed and for 
characters which are not the first three characters of one of the 
twelve months; if any error is found, a rnessage is printed and a blank 
date is produced (i,e, , the location in which the date is stored is 
padded with nulls and dashes are printed during directory listings) . 

The current date as entered by the user will appear in directory 
listings (see Section 3.3.5), in Linker load maps, and in PAL assembly 
listings, and the date of creation of all new files will also be in- 
cluded. If the date command is not used, directory listings will con- 
tain only filenames, extensions, and previous creation dates. 

When the user enters a date, it is stored in a part of memory that is 
not likely to he overwritten (and therefore destroyed! by the user or 
by the CAPS- 11 System. The user should update his system from day to 
day to prevent wrong dates from being assigned to files. Very 
infrequently (if ever) that part of iMsmory holding the date may be 
overwritten in such a way as to cause random characters to be printed 
in place of the date. The user need only tyi^ in the current date 
using the DATE command to correct this condition. 



3.3.5 DIRECTORY Conmand 

The Dlltectory command is of the form; 

.DI[R] I/P] [rCT]#j] 

and causes a directory listing of the cassette on the indicated drive 
to be output on the console terminal. For examples 
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.DIR CTl! 
03- APR- 7 3 



FAD 



SLG 03- APR- 7 3 



BA 



I 



27-MAR-7 3 



The /F switch is optional; if used, it causes a "fast" listing to be 
produced by omitting current and creation dates and listing only 
filenames and extensions. For example: 

.DIR/F li 



ABC 


SLG 


fEMPTr 




PRO 


LDA 



If a file has been deleted from a cassette using PIP <see Chapter 8) 
its filename and extension will be replaced by the header *RMPTY in 
the directory listing. To delete *EMPTY files from cassettes, the 
user must first transfer all needed files to another cassette (using 
PIP) and then zero the first cassette, or use the SENTINEL command, 
explained in Section 3,3,7, 

If no sentinel file is present on the cassette, the error message: 

HMO SENTINEL FILE 

will be printed following the directory listing. (This condition 
occurs when an open file on cassette has not been properly closed.) 
The user should write a sentinel file on the cassette using the 
SENTINEL command. While files may be read from a cassette which 
contains no sentinel file, they may not be written. 



3.3.6 ZERO Command 

The ZERO command is of the form: 

.ZtERO] [CT]#: 

and causes the indicated cassette to be zeroed, or completely deleted 
of files; the sentinel file is written at the beginning of the 
cassette so that the entire tape is available for use. A cassette 
number must always be indicated as the ZERO command does not assiune 
drive . 

All new cassettes should be zeroed before they are first used. Tliis 
ensures that a sentinel file is present at the beginning of the tape. 



3.3.7 SENTINEL Command 

The SENTINEL command allows the user to 'zero' part of a cassette by 
deleting all files following a given filename. The form of the 
command is : 

.SE [NTINEL] [ [CT] # : ] FILTOA.RXT 
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This command causes the sentinel file to be %fritten iifiiiedlately 
following FILENA.EXT, thereby effectively 'zeroing' the remainder of 
the cassette. For example, assume the directory of the cassette on 
unit drive 1 is i 

SIZE LST 
♦EMPTY 

BLANK SLG 

FORTY DAT 

and the user types s 

.SE liSlJE.LST 

The directory of the cassette will now read: 
SIZE LST 

Cassette drive is assumed if no drive nm?4>er is indicated in the 
coMTiand line. 



3.3.8 VERSION Command 

The VERSION command is used to find out the version number of the 
Monitor currently in use. Typing: 

,V(ERSIONj 

instructs the tenitor to respond with the Monitor identification, 
version number, and current date. For example j 



CAPS- 11 V01-e2 
g7-AUG-73 

Version 01-02 is currently in use. As new versions of the Monitor are 
released, this number will be updated accordingly. Any coiraitunications 
with Digital Equipment Corporation concerning the CAPS-11 System 
should indicate the version number of the Monitor currently in use. 



3.4 KEYBOARD MONITOR SECTIONS 

That part of the CAPS-11 System terried the Keyboard Honitor {and 
stored on the System Cassette as CAPS 11. SYS) is actually composed of 
several subprograms (such as CSI and KBL) which are responsible for 
various stages of system and user interaction. As already mentioned, 
the first step in using the CAPS-11 System is to bring these 
subprograms into memory and begin their execution, "The user begins 
the loading process when he starts the bootstrap loader (CBOOT) . When 
the Monitor has been completely loaded and is ready for use, it 
resides in memory as shown in Figure 3-1 i 
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Figure 3-1 CAPS-11 Memory Map 



Each of the Monitor subsections will be discussed briefly. A detailed 
description of the Monitor loading process, information concerning 
loader formats, and Switch Register settings for use with Monitor 
loads and error halts may be referenced in Appendix E. 

3.4.1 Cassette Bootstrap (CBOOT) 

The Cassette Bootstrap is used to load and start any program which is 
in •CBOOT Loader Pomat* (such as CTLOAD.SYS). CBCX3T has already been 
mentioned in Section 3.1 as being instruir^ntal in loading the CAPS-11 
Monitor into memory. A complete listing of CBCX>T and moat information 
concerning its use in the CAPS- 11 System is provided in Appendix E, 

3.4.2 Itesident Monitor (REKMON) 

Input and output operations are handled by RBSMON, which contains 
routines for all file-structured cassette I/O, and all teleprinter, 
keyboard, and line printer I/O (with the exception of CABLDR which 
contains the I/O routines necessary for performing the LOJUD/0 c^araand, 
as described in Section 3.4,5) Usually RESMON is never overwritten but, 
is always available in raea«iory for access by the user (again, cui 
exception occurs when processing the LOAD/O command). Chapter 9 
provides specific information concerning the way RESMOM works and 
methods by which the programmer can utilize BESM)N in his cwn 
programs. 

RESMON also contains the System Communication Area (SYSCOM) , which 

provides to the user and to various system progrmns information 
concerning available memory cuid locations of important Monitor 
routines {see Section 3.4.7). 
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3.4.3 Cassette Loader for CAPS-11 (CLODll) 

CLODll is used in the execution of the RUN, LOAD, and LOAD/G Monitor 
commands by directing the loading of prograuns when these comands are 
issued. In the case of the RUN conmand, the user may simultaneously 
interact with the CSI while program loading is occurring (i.e., he may 
enter his I/O command string even though the program load is in 
progress). CLODll performs error checking and reports certain types 
of errors to the user; these are listed in Teible 3-8. 



3,4,4 Command String Interpreter (CSI) 

The Command String Interpreter (CSI) is used by all system programs 
(with the exception of the Editor and ODT) and may be used by any user 
program which is loaded and started via the Monitor RUN command. When 
the user runs a prograun, the CSI responds by printing an asterisk {*) 
at the left margin of the console terminal page; the user responds by 
entering all device and file I/O information needed by the program. 
The CSI then constructs a table which contains the information entered 
by the user. This table is described in more detail in Section 3.5, 



3.4,5 Cassette Absolute Loader (CABLDR) 

CABLDR is used to load programs written in 'Absolute Binary Format' 
which is the format of all system programs and all Linker output (see 
Chapter 6) . CABLDR performs error checking during program loads and 
halts upon any error indication, at which time the user may set the 
Switch Register to direct further action. Refer to Appendix E for 
detailed information concerning user interaction with CABLDR. 



3.4.6 Keyboard Listener (KBL) 

The Keyboard Listener is that part of the Monitor responsible for 
printing the dot at the left margin of the teleprinter page, 
indicating to the user that he may enter any one of the eight Monitor 
commands discussed in Section 3.3. The KBL is also responsible for 
positioning the cassette tape for proper loading during a RUN, LOAD, 
or LOAD/G command; it then passes control on to CLODll, which handles 
the actual loading during processing of these commands. 



3.4.7 System Communication (SYSCOM) 

The System Communications Area (SYSCOM) resides in absolute locations 
40 through 57 and is loaded into memory (as part of the RESMON source 
code) as shown previously in Figure 3-1. This area provides a means 
of communication between the Monitor and other programs not linked 
with it, such as system and user programs. 

The following information is classed into two sections — that which is 
of general interest to the user, and that which is used by CAPS-11 
system programs and which may be helpful to user programs requiring 



3-18 



non-standard services. The user 
conjunction with this information. 



should refer to Section 3.5 in 



SYSCOM — General Information 

During normal system use, the £d)solute locations listed in Table 
are accessed and manipulated by the CAPS-11 System as noted: 
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Table 3-6 
General Locations 



Location 



Function 



HIFBEE Absolute location 42 — this word contains the 
address of the highest location available to the 
user for program loading and storage which 
precedes the 'expected' portion of the Monitor 
still residing in memory. For example, after a 
LOAD/G command, the user can 'expect' that all of 
RESMON will remain intact, and thus HIFREE will 
contain an address equal to the start of RESMON 
minus two (bytes). After a RUN command, HIFREE 
will usually contain the starting location of the 
CSI table minus two. After a LOAD/O command, 
HIFREE will contain the address immediately 
preceding the beginning of relocated CABLDR; the 
user can plan to use all locations through the 
location contained in HIFREE amd still preserve 
CABLDR. 

DATPTR Absolute location 54— this word contains the 
ciddress in RESMON of the current date (as input by 
the user via the Monitor DATE command) . The six 
bytes starting at this location contain, in orders 

two ASCII bytes containing the day 

two ASCII bytes containing the month number 

two ASCII bytes containing the year 

LPSIZE Absolute location 40 — this byte contains a number 
which is one greater than the total number of 
character columns existing on the user's line 
printer (i.e., 133 (or 205 octal) for the standard 
system; 81 (or 121 octal) for a non-standard line 
printer) . 

HLTERR Absolute location 41 — this byte is examined by the 
cassette interrupt handler upon every occurrence 
of a controller error. If this byte has been set 
to non-zero by the user (never by the system) , the 
interrupt routine will halt whenever an error is 
detected so that the user may examine the cassette 
status register. Pressing the CONTinue key on the 
processor console will cause the software to con- 
tinue. This byte is provided primarily as a hard- 
ware debugging aid. 
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SYSCOM—Special Information 

The following SYSCOM locations exist primarily for use by CAPS-11 
system programs and should be accessed by the user with caution. 
These locations should not be modified except as indicated. 



Table 3-7 
Special Locations 



Location 



Function 



KBLHES 



CSIADR 



Absolute location 52 — this byte is a flag 
indicating the state of the non-resident portion 
of the Monitor. It is initially set to -1 when 
the system is bootstrapped to indicate that the 
entire Monitor is resident; it is cleared when a 
LOAD/G, LOAD/O, or RUN command sets HIFREE above 
portions of the Monitor in order to allow maximum 
loading and storage space. KBLRES is interogated 
by the CTRL/C and fatal error routines to 
determine whether a complete reboot is necessary 
or whether the Monitor need only be restarted (if 
KBLRES=0, the Monitor may not be entirely 
resident). Certain system programs (EDIT, LINK, 
ODT, PIP) do not require the extra memory space 
made availeible when the Monitor is overwritten. 
Thus, even though KBLRES is cleared when these' 
programs are loaded, they do not actually use any 
of the memory space provided between the beginning 
of the Monitor cind the beginning of RESMON. In 
order to prevent a CTRL/C or fatal error fron 
causing a complete reboot of the Monitor, these 
programs each reset KBLRES to -1. User programs 
may also set KBLRES to -1; the user program should 
be linked with the program KBLRES. OBJ which is 
supplied on one of the OBJ Cassettes; this process 
is described in Section 3.5. 

Since a START command always clears KBLRES after a 
load is complete, KBLRES must be set to -1 at 
run-time rather than at load-time (using the 
instruction MO\/B #-l,@#52) in order to ensure that 
the system will assume the Monitor is intact. 

Absolute location 46 — this word contains the 
starting address of the CSI, It is used by 
certain system programs to call the CSI, enabling 
entry of another command string after action on a 
previous string has been completed. Note that the 
CSI is reusable only if it has not been 
over-written . 



(Continued on next page) 
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Table 3-7 (Cont,) 
Special Locations 



Location 



KBLADR 



ZEMX):^ 



CSITBST 



FILWRD 



Function 



Absolute location 50 — this word contains the 
starting address of the KBL which is also the 
lowest address in the Monitor, System software 
restarts the Monitor at this address whenever a 
CTRL/C or fatal error condition occurs providing 
the Monitor is resident (i.e.^ if KBLRES is 
non-ssero) . Note that the user may compare the 
address in KBLADR against his use of memory to 
dete:rniine whether his program must set KBliRES in 
order to allow a quick restart of the Monitor, 

Absolute location 53 — this byte (which is 
initialized to —1) is cleared by the Asseiribier 
(PAL) to indicate that raenrary should be cleared 
before the final section of PAL is loaded. This 
is necessary since the portion of PMi containing 
the symbol table must 1^ loaded Into zeroed 
memory. This byte may be cleared by any user 
program which requires use of the CSl. Such use 
is not reconumended without a careful reading of 
the CLODll source listing (available from the 
software Distribution Center) . 

Absolute location 44 — this word holds the starting 

address of the csi table as it resides in memory. 
It is used by system programs which inake use of 
the CSI , and may be utilised by atiY user programs 
which use the csi. 



Absolute location 
information vrtiich is 
handle differences in console 
terminals {such as a serial 

require that a certain character 

return or line 
Rjost characters 



56— 'this word contains 

used by KBSMON and ODT to 

terjfiinals , Some 

I,A30 and a ¥T05) 

(e.g., carriage 

feed which both take longer than 

to print on the terminal 1 be 



followed by a number of "pad' or 'fill' 
characters. The low-order byte of FlLWRD 
(absolute location 56) contains the character 
which must be filled {or if none must be 
filled) ; the high-order byte (absolute location 
57) contains the number of 'fill* characters 
required. RESMON and OOT will type this number of 
nulls (ASCII 000) after the character specified by 
byte 56, 



3.5 USER PROGRAM LDADIMG PROCESS 

The CAPS- 11 Mcaiitor attempts to pzovide the user at all times with 
maximum loading space and maximum ste)rage space for system and user 
programs. It does this by allowing unneeded parts of the Monitor to 
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be overwritten and by moving necessary sections to higher positions in 
memory. The SYSCOM parameter KIFREE is used at various tines during 
the loading process to indicate the highest location into which user 
(or system) programs may be loaded and the highest free location 
available for use which still preserves RESfON (and possibly the CSI 
table) . Since the goal of the system is to maximiKe such areas, 
HlFraiB will usually be set at points ahovA Monitor components which 
are not needed for loading or I/O, even though a user program may not 
actually overwrite the Monitor, When HIFHEE is to be set to locations 
above any Monitor location, the SYSCOH flag KBLRES is cleared to 
Indicate that the Monitor may not be intact. This has the result of 
causing a physical reboot (requiring approximately 30 seconds) upsn 
occurrence of any fatal error or CTRL/C command. Instead of a simple 
restart of the KBL, In order to avoid a possible physical reboot of 
the system in cases such as this, the user Hiay link his program with 
the object module KBLRES. OBJ on the Build Cassette. This program is 
merely: 

.ASECT 

.=S2 ;loc. of KBLRES I ^^ srsco^ 

• BfTE-t J -SARK '<BL AS RESiDE-JT 

KBLRES. OBJ should be the first program in the Linker input string. 
Loading of this code will reset the SYSCOM KBLRES flag which is 
cleared before loading. 

The user who wishes to load Mid execute a program has four methods 
available to him (reference should be made to Figure 3-1 while reading 
the following) s 

1, Assuming the program has an extension of .SRU or any 
user-assigned extension other than .SLG or ,SLD, the RUN 
coiranand may be used to automatically load and start the 
program. MM allows use o£ the CSI, and RBSMON is 
available to handle all I/O within the user program. 
The loading procedure is as follows s 

The cassette is first properly positioned for the loadj 
when this is done, the KBL and CABLDR are no longer 
needed and may be overvirittan. The CSI builds a table 
which contains all the I/O information which the user 
has entered. 300 bytes are initially reserved for the 
table, and once it is built and its actual size is 
determined, it is laoved to occupy memory just below 
CLODll, Thus, prc^ram loading may use all n»mory space 
to the bottom location of the CSI table. 

When loading is complete , CLODll is no longer needed. 
In order to maximize free n^mory space, the CSI table is 
standardly moved up over CKJDll so as to be positioned 
immediately under RESHON. This destroys CLODll and 
makes it necessary to reboot the system upon occurrence 
of a CTRL/C or fatal error. To avoid this action (in 
cases where the user program does not need space above 
the start of the Monitor, i.e., above KBL), the user may 
link KBLRES. OBJ with his program as described 
previously; the second niovement of the CSI table will 
thus be prevented. 



"^ 
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The 300 bytes originally reserved for the CSI table is a 
parameter which may be changed by the user during 
reassembly of the CAPS-11 Monitor, 



2. TOie second choice available to the user for loading and 
executing a program is to use the LOM) (and STAM*) 
cotnmand. The load command allows a prograin to be loaded 
only to the bottom location of the KBL^ preserving the 
entire Monitor for future use. 

3» LOAD/G {and RUN used with the .SLG extension) May be- 
chosen to load and start a program as follows t 

Before the file is loaded, the cassette is physically 
positioned before the data of the file, KBL and CABLDR 
may then be overwritten since CLODll now directs the 
program load. Program loading may occur to the bottom 
location of CIJODll. After the load, CLODll is no longer 
needed, so the user has the entire memory below RESMON 
available for storage space. RESMON is preserved to 
handle I/O within the user's program. However, the rest 
of the Monitor is not preserved and no future Monitor 
commands are possible. 

4. The LOAD/0 conraand (and RUN used with a .SLO extension) 
allows a program to be loaded providing maximum load and 
storage space. The cassette is positioned for the data, 
and CABLDR is moved into highest memory with CBOOT, 
where it directs program loading. Loading may occur to 
the bottom location of CABLDR in its new position, and 
after loading, the entire menory Is available for 
storage. Since no part of the Monitor in preserved, the 
user program must handle its own I/O^ and no further 
Monitor commands or functions are available for use. 



3.6 NOTES ON reVICE HMTDLERS 

The line printer prints characters as they appear in the buffer. Tabs 
are output as spaces to the next tab stop (stop® occur every S 
character positions) . Carriage returns are ignored since a form feed 
or line feed is assumed to follow causing the carriage to advance to 
the beginning of the next line, if more than 132 characters in a 
single line are output, the line printer handler issues a carriage 
return/line feed after the 132nd character and continues output on the 
next line, (See Appendix E for instructions regarding changing the 
length of the LPT line from 132 to 80 columns.) 

If the console terminal is an LT33 Teletype containing reader and 
punch units, these may be used as input/output devices in conjunction 
with the Teletype keyboard. To punch a tape, simply place the punch 
unit to ON; to read a tape, place the reader unit to START, 
Characters will be printed on the Teletype keyboard as they are read 
or punched. 

The high-speed reader and punch may be used by PiP. Refer to Chapter 

8 for details* 
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3.7 KEYBOARD MONITOR ERROR MESSAGES 

Table 3-8 lists all error messages output by the system and lists the 
source of each error. These messages are preceeded by one of two 

symbols j 

7 Non-fatal error; execution continues if possible; 
otherwise control returns to the CBI after the 
message is printed. 

% Fatal error; control retuins to the KBL (if the 
Monitor is entirely resident, the user will s^ 
the dot printed after the message; if the Monitor 
is not resident, the system will type +C? on the 
line following the message; the user should ensure 
that the System Cassette is mounted on drive 0, 
and then type auiy character on the keyboard to 
initiate a reboot) , 

Sorae itessages may haire numeric arguments which follow the nsessage 
itself; these usually indicate either the drive nuiruber or the program 
counter. Note that messages which have RBSMDN as their source are 
those which the user may see during operation of his program. 

Note also that CSI error messages ending with a colon (:) are followed 
by a line containing all command string characters entered until 
detection of the character in error (which is indicated by a ? ) . 









Table 3-8 






Keyboard 


Monitor Error Messages 




Message 


Arg 




Meaning 


Source 


lOT 


PC 




Illegal lCS?f user 
specified an illegal 
device or data mode^ or an 
illegal BEBMON lOf code. 


RESMON 


NO F1I.E OPEN 


drive 


# 


READ or WRITE with no 
SEEK or EfWER 


HESMOM 


OFFLINE 


drive 


# 


Cassette not mountted? if 
neat-fatal, execution is 
automatically resumed when 
the cassette is mounted (if 
the user improperly mounts the 
cassette, a fatal error will 
probably occur) 


RESMON 


TIMING 


drive 


# 


System software did not 
service an initiated 
request fast enough 


RESMON 



(Continued on next page) 
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Table 3-B (Cont. } 
Keyboard Monitor Error Messages 



Message 


Agr 


Meaning 


Source 


TRAP 


PC 


Stack overflow, reference 
to non-existent memory, 
illegal or i^served 
instruction, attempt to 
reference a word on a 
byte boundary? the SP at 
the time, of the trap is 
stored in location 44 


RESMOH 


wHT lcx:k 


drive # 


Cassette write-lockedj if 
non-fatal, execution is 
autonaticaly resumed when 
the cassette is write-enahled 


HBSMON 


FILE NOT FMD 




Specified file not 
found 


KBL 


ILL, CMD 




Illegal command 


KBL 


NO SENTINEL FIT.F, 




No sentinel file is 
present on the tape? 
this RKssage may occur 
during use of the DIRECTORY 
command at that point during 
the directory listing where 
tJie sentinel file is missing 


KBL 


SYNTAX ERROR 




Arguments following a 
command are illegal 


KBL 


BAD TAPE 




Hardware checksum error 
{note that this error 
may also be caused by 
READ operations initiated 
on a cassette which is 
positioned after the 
sentinel file) 


KBL, 
CLODll 


WO STAICT ADDR 




Loaded program had no 
transfer address 


KBL, 
CLODll 


PRDG TOO BIG 




Program too big for the 
memory limits defined by 
the tyi® of load used 


CLODll 


SFTWR CHKSM ERR 




Software checksum error 

(message followed by nmnber 
of errors) 


CLODll 


THUNCATED FILE 




File ends before transfer 
address load block is 
found 


CLODl 1 



[Continued on next page) 
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Table 3-8 (Cent.) 
Keyboard Monitor Error Messages 




Message 


Arg 


Meaning 


Source 


CSI TABLE 
OVERFLOW 




Coranand string too big 
for the table 


CSI 


ILLEGftl CHARS 


(C.S, 
line) 


Illegal character in 
command string 


CSI 


ILLEGAL DEVICE: 


(C.S. 
line) 


illegal device 
specification 


CSI 


ILLEGAL SYNTAJCi 


(C.S. 
line) 


Illegal syntax in 
command string 


CSI 
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CHAPTER 4 
EDITING THR SOURCK PRW^HAM 



The Text Editor (EDIT) is used to create anfl modify ASCII source 
files. Controlled by user cofsiands froF- the keyboard » EDIT reads 
ASCII files frors cassette, raakes specified changas, and writes ASCII 
files back to cassette or lists tlien on the line printer or console 
terroinal. 

The Editor considers a file to be divided into logical units called 
pages. A page of text is generally 5O-'G0 lines long (delimited by 
form feed characters) and corresponds approximately to a physical page 
of a program listing. The Editor reads text from the input file into 
two internal buffers; from these buffers text is then called^ a page 
at a time, into the Text Buffer where the page becomes available for 
editing. Editing conmands can then be used tos 

Locate text to be changed 

Execute and verify changes 

Output a page of text to the output file 

List an edited page on the line printer or console terminal 



4.1 CALLING AND USING THE EDITOR 

The Editor Is called from the System Cassette by typing: 

iR EDIT 

in response to the dot printed by the Keyboard Listener. 1«Jhen the 
Editor is in memory and ready to accept I/O specifications, an 
asterisk (*) is printed at the left margin of the console terminal 
page < 
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4.1.1 Editor Options 

None of the options previously listed in Chapter 3 are used by the 
Editor. An autonatic overflovf feature is provided, however; if the 
Editor discovers an end-of-tape condition, it prompts the user to 
mount a new cassette and output is continued on this cassette under 
the same output filename originally specified hy the usar Csee Section 
4.4.6). 



4.1.2 Input and output Specifications (Edit Read and Edit Write) 

The Edit Head command opens a file for input. The form of the conmand 
is: 

*ER#fPILENA.EXT 

where # represents the unit drive number and FILNAH.EXT the file to be 
opened. If no drive number is specified, the SyBtera Cassette— drive 
0--is assumed; if no extension is indicated, .PAL is assumed. Any 
file currently open for input is closed. Edit Jtead Inputs enough text 
to fill its two internal input buffers; text is not read into the Text 
Buffer however, and the contents of the other user buffers are not 
affected. 



For example ! 

*ERlsSAMP*$ 



Open for input the file SAMP. PAL 
on cassette drive #1 ($ represents 
typing the ALTMODl key) 



The Edit Write command sets up a new file for output (however, no text 

is output to cassette and the contents of the user buffer.*? are not 
affected) . Any current output files are closed and a new output file 
with the specified name is opened on the indicated cassette drive. 
The form of the command is : 

*BWi!FILENA.EXT 
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NOTE 

A cassette which is currently open for 
an output operation cannot be 
simultaneously opened for an input 
operation. If this is attempted, the 
error nessage; 

?*I/0 CHAN COf^FLICT*? 

is printed. However, a cassette which 
is currently open for input can be 
opened for output? the cassette is 
repositioned to write the output file? 
no further input from that cassette is 
then possible until the output file is 
closed. 

If a file with the same name already 
exists on the cassette indicated in the 
Edit Write command, the old file will be 
destroyed when the user executes an EXit 
or f;nd File command. 

The user may create a new file by first opening an output file (via 
the EW command) and then creating the text using the Insert command 
(see Section 4.4.9); the new text will be stored on the drive under 

the filename indicated in the EW command. since a new file is being 
created, no input file need be open to perform this operation. 

Examples of use of these commands are ; 



♦ ERltTEST.LSSS 



♦ EWriLEl. DATSS 



Open the file TEBT.LS on cassette 
drive 1 for input. 

Open the file FILEl.DAT on drive 
(the System Cassette) for output. 



♦EWlsOUT.TXTSf 
*I • • • text* • • 



Open t]ie file OUT, TXT on drive 1 
for output. There is no input file? 
a new file will be created using the 
Insert command. 



4,1,3 Restarting the Editor 

The Editor may be restarted at any time (while it is in n»mory) by 
typing CTRL/P. This echoes as P on the console terminal followed by 
a carriage return/line feed. The Corwiand String interpreter prints an 
asterisk at the left margin indicating that it is ready to accftpt 
another Editor command. All open files are closed and all buffers are 
cleared. 
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4.2 MODES OP OPERATION 

The Bditor operates in one of two different modes; Command Mode or 
Text j^tode. In Connand Mode all input typed on the keyhoard is 
interpreted as commands instructing the Bditor to perform seme 
operation. In Tejct Itode all typed inptit is interpreted as text to 
replace, be inserted into, or be appended to the contents of the Text 
Buffer, 

Inmediately after being loaded into memory and started, the Editor is 
in COTTOiand Mode, The special character <*} ±s printed at the left 
margin of the console terminal page indicating that the Editor is 
waiting for the user to type a command. All commands are terminated 
by pressing the ALTf^ODE key twice in succession. Execution of 
commands proceeds from left to right, should an error be encountered 
during execution of a command string, the Editor will print an error 
message followed by an {*) at the beginning of a new line indicating 
that it is still in Command Mode and atfaiting a legal comriand. The 
command in error (and any succeeding coFnands) are not executed and 
iTiUst be corrected and retyped. 

Text mode is entered whenever the user types a coiranand which must be 
followed by a text string. These commands Insert, replace, exchange, 
or otherwise majtipulate text; after such a command has been typed, all 
succeeding characters are considered part of the text string until an 
ALTMODE is typed. The ALTMODE terminates the text string and causes 
the Editor to reenter Command Mode, at which point all characters are 
considered commands again. 



4.3 SPECIAL KEY C0MI.1ANBS 

Special EDIT key conmands are listed in Table 4-1. (Control commands 
are typed by holding down the CTRL key while typing the appropriate 
character. ) 



Table 4-1 
EMT Key Commands 



Command 


Meaning 


ALTMODE 
CTRL/C 


Echoes as a $ character, A single 
ALTMODE terminates a text string. A 
douljle ALTMODE executes the command 
string. For examples 

♦GHOV A#iLS- IDSS 

Echoes at the terminal as c. Typing 
this coFinand terminates execution of 
EDIT comands and initiates a return to 
the KRL. Any open files are first 
closed, and the contents of the Text 
Buffer are lost. (see Chapter 3, 
Section 3.2,5) . 



(Continued on next page) 



4-4 



Table 4-1 (Cont.) 
EDIT Key Commands 



Ccfffmaml 



Iteaniny 



CTRL/O 



CTRL/P 
CTRL/U 



RVnOUT 



TAB 



Echoes as +0. This comm?ind inhibits 
printing on tlie console terminal until 
conpletion of the current command 
string. Typing a second CTRIj/O will 
resume output {see Chapter 3, Section 
3.2.5). 



Echoes as +P and restarts 
{sese Section 4,1.3) 



the Editor 



Echoes as tU. This corviand deletes all 

the cliaracters on the current input line 
(see Chapter 3; Section 3.2.5). 

Echoes as +X and causes the Editor to 
ignore the entire command string 
currently being entered. The Editor 
prints a carriage return/line feed and 
an aBterl.sk to indicate that the user 
may enter another command. 

The RUBOIIT key is used to delete a 
character fron the current line and may 
be used in both Conmand and Text Modes f 
it echoes a backslash follovred by the 
character deleted. Each succeeding 
RUBOUT typed by the user deletes and 
echoes another character. An enclosing 
backslash is printed when a key other 
than RUBOUT is typed. This erasure is 
done right to left up to the last CR/LP. 

Note that RUBOUT used under control of 
the Editor echoes deleted characters 

somewhat, differently than when using 
other system programs. 

Spaces to the next tab stop. Tab stops 
are positioned every 8 siiaces on the 
terminal J typing the TAB key causes the 
carriage to advance to the next tab 
position. 



4.4 COiMfMAND STRUCTURE 

Editor commands can be categorized as belonging to one of five groups ; 
a) those coKaands which allow text to be input from cassette and 
output to either cassette, lii^ printer, or the console terminal; b) 
those commands which allow the character location pointer to be moved? 
c) those coFitiands which perform searches in the text for specific 
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characters or strings of characters; d) those connands wliich cause the 
text to be modified either by insertion of new text^ or deletion or 
relocation of existing text; and e) a sijecial classification of 
commands called utility conFiands. 

The general format for the EDIT conmand string i<s: 

nCtext? 

nCS 



or 



where n represents one of the legal arguments listed in Table 4-2, C 
is a one or two letter command, and taxt is a string of successive 
ASCII characters. As a rule, commands are separated from one another 
by a single ALTMODEj hot/ever, if the comnand reqtiires no text, the 
separating ALTMODE is not necessary. Commands are terminated by a 
single ALTMODE; typing a second ALTMQDK begins execution. 



4,4.1 Argiinients 

ftn argument is positioned before a command letter and is used either 
to specify the particular portion of text to be affected by the 
comnand or to indicate the ntimber of times the command should be 
performed. With sopie commands this specification is implicit and no 
argiunents are needed; other Editor commands require an argument. 
Table 4-2 lists the fomats of arguments which are used by commands of 
this last type. 



Table 4-2 
Coramand Arguments 




Meaning 



n stands for any integer in the range -16383 to 
■i-16383 and may, except where noted, be preceded by a 
+ or -. If no sign precedes n, it is assumed to be 
a positi^»'e number. Whenever an argument is 
acceptal^tle in a command, its absence implies an 
argument of 1 (or -1 if only the - is present) , 

refers to the )>eginning of the current line. 

/ refers to the end of test in the current Text 
Buffer. 

= is used with the J, D and C comr^ands only and 

represents -n, where n is equal to the length of the 
last text argument used. 



The roles of ail arguments are explained more specifically in 
following sections. 
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4.4.2 Copimand Strings 

All EDIT command strings are teminated by two successive ALTICtDE 
characters. Spaces, carriage returns and line feeds within a command 
string are ignoi^d (they are not ignored if they appear within a taxt 
string). Conmands used to Insert text can contain text strings that 
are several lines long^ in vrtiich case each individual line is 
terminated with a carriage return/line feed <CF/LF) and the entire 
command is teminated with a double ALTMODE, 



Several commands can he strung together and executed in sequence, 

example j 






iBGMOy PC*R0S-2CRt$SKQCLR »R2S$ 



MOTE 



If a connand currently being entered by 
the user is within 10 characters of 
exceeding the space available in thi© 

Command Buffer, the message: 

* CB ALHOST FULL ♦ 

is printed (the Command Buffer holds the 
corunand string until it is executed; B&e 
Section 4.4.10), If the command can be 
conpleted within 10 characters, the user 
may finish entering the cormand; 
otherwise he sltouid type the ALTflODE key 
twice to execute that portion of the 
command line already completed. "The 
nessage is printed each tine a character 
is entered in. one of the last 10 spaces. 



If the user attempts to enter more 
10 characters the message: 



t!!. Hi! €111 



7GB FU1,U? 

is printed and all comnands typed within 
the last 10 characters are ignored. The 
user again has 10 characters of 
available space in wtiich to correct the 
condition. 



Execution of a command string begins when the double ALTMODE is typed 
and proceeds from left to right. 



4,4.3 The Current Location Pointer 

Most EDIT ccninands function with respect to a movable reference 
pointer which is normally located bet*/een the most recent character 
operated upon and the nej<t character in the buffer. At any given time 
during the editing prcxiedure, the pointer can be thought of as 
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representing the current potsition of the Editor in the text. Most 
commands use this pointer as an implied argument; commands are 
available for moving the pointer anyvjhere in the text, thereby 
redefining the current location and allowing greater facility in the 

use of other coMnands. 



4.4.4 Character anti Line Oriented Command Pixiperties 

when using character oriented commands , a nuneric argument specifies 
the nunber of characters that are involved in the operation. Positive 
arguments represent the masher of characters in a forward direction 
Cin relation to the pointer) , negative argiments the nwnber of 
characters in a backward direction. Carriage return and line feed 
characters are treated as any other character. For example, assume 
the pointer is positioned as indicated in the following text; each 
line of text is terminated by a carriage return/line feed^ indicated 
here ^Y J ^ • 



MOV #VECT*RgPi^^ 
CLR iR2^ \ 



Pointer is here 



The EDIT copimand -2J causes the Editor to move the pointer backwards 
by 2 characters. 



Pointer is now here 



MOV #VECT>.Ra.J i 

CLR •R2p \ 

The command lOJ advances the pointer forv-zard by 10 characters and 
places it between the carriage return and line feed characters at the 
end of the second line. 



MOV #VECT#R2J 1 

CLR tR2^J 



Pointer is now here 



Finally, to place the pointer after the "C" in tte first line, a 
command is used. 



-14J 



Pointer is here 



MOV *^EC,Tj R2j I 

CLR eRg^Y 

The J (Jump) command is explained in detail in Section 4.4,7, 

When using line oriented coFimands, the nurieric argument represents the 
numlser of lines involved in the operation. The Editor recognizes a 
line as a unit when it detects a CR/LP coFhination in the text. When 
the user types a carriage return, the Editor automatically inserts a 
line feed. Positive arguments represent the nuriber of lines forward 
(in relation to the pointer) t this is acconplished by counting CR/LF 
combinations l>eginning at the pointer. Hence, if tha pointer is at 
the beginning of a line, a line oriented conmand arguinent of +1 
represents the entire lina between the current pointer and the 
terminating line feed. If the current pointer is in the middle of tixe 
line, an argument of +1 represents only that portion of the line 
between the pointer and the terminating CR/LF. For exaraple, assume a 
buffer of I 
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MOV J'C^ R 1 J I Pointer is here 

ADD #DR1V-.,R1P4 

MOV ^VECT^Rgj^i 

The command to advance the pointer one line CI A) cause."? the following 
change t 

MOV pc#rO| 

,ADD #DRIV-.jRQi Pointer is ncM* here 

MOV #VECT.Rap[ 

The command 2A moves the pointer over 2 CR/hF combinations: 

MOV PCjRl^i 

mo #DRIV-,»Rl3^ 

MOV #VECT,R2^i 

^CLR »R2p^ Pointer is now here 

Negative arguments represent the numJ^er of lines backward in relation 
to the pointer. Consequently, if the pointer is at the beginning of 
the line, a line argument of -1 means "the previous line" (moving 
backward past the first CF/LF and up to but not including the second 

CR/LP) ; if the pointer is in the middle of a line,, an argtunent of -1 

ineans the preceding 1 1/2 lines. For example, given the textj 

HOV PC#R1^4 

ADD #DRIV-.,rO I 

MOV «VECyv*_Ra2i Pointer is here 

CLR 9R&J1 

A command of -lA itio-^^s the pointer back I 1/2 lines. 

HOV PC.Rl^i 

^A DP #ORI V- . , R 1^ I Pointer is here 

MOV fVECTjRSJi 

a.R «R2^ ; 

NoiiT a coimand of ~1A backs the pointer by only 1 line. 



4.4,5 Repetitive Execution 

Portions of a comand string may be executed more than once by 

enclosing the desired portion in angle brackets to} and preceding the 

left angle bracket with the nimber of iterations desired. The 
structure is: 

Cl$C2Sn<C3SC4?>C5S$ 

where Cl,C2,,.C5 represent commands and n represents an iteration 
argument. Conwiands Cl and C2 are each executed once, then commands C3 
and C4 are executed n tii^s. Finally, command C5 is executed once and 
the command line is finished. The iteration argument Cn) must be a 
positive nuinber (1 to 16384); if not SL^ecified, it is assumed to be 1, 
If the number is negative or too large, an error message is printed. 
Iteration brackets may be nested up to 20 levels. Command lines are 
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checked to make certain the brackets are correctly used and match. 
For example, the following bracket structure is legal: 



<<><<<><>>>> 



■while these structures are considered illegal and will cause an error 

message: 



><>< 



<<<>> 
As an example, assume the user wishes to input a file called SAMP 
(stored on cassette drive 1) and change the first four occurrences of 
the instruction MOV |aOO,KO on each of the first five pages to 
MDV #244, R4. He enters the following- coinnand line (coranands used in 
this example are explained in detail later in the chapter) i 

• ERl ! SANP$5<R4< BGHOW #300* Ft0S=J S3< G0S= Q4S>>> »» 

t ^ 



The command line contains 3 * sets' of iteration loops (A, B, C) and is 
executed as follows: 

Execution initially proceeds fropi left to right; the file SAMP on 
drive 1 is opened for input and the first page is read into memory. 
The pointer is moved to the beginning of the buffer and a search is 
initiated for the character string MOV #200, RO. When the string is 
found, the pointer is positioned at the end of the string, but the =J 
Gomriand moireis the pointer back so that it is positioned immediately 
preceding the string. At this point, execution has passed through 
each of the first t^o » sets' of iteration loops (A, B) once. The 
innermost loop (c) is next executed three times, changing the 0*s to 
4's. Control now moves back to pick up the second iteration of loop B 
and again raoveB from left to right, when loop C has executed three 
tines control again moves back to loop B. Iften loop B has executed a 
total of 4 times, control r,oves back to the second iteration of loop 
A, and so forth until all iterations have been satisfied. 



4,4,6 Input and Output Gopwiands 

Input commands are used to read text into the Text Buffer where it 
then becomes available for editing or listing. Output commands cause 
text to he listed on the console terminal or line printer, or written 
out to cassette. Some commands are specifically designed for either 
input or output functions, while a few commands serve both purposes. 

If an output cassette becomes full during any output operations, the 
Editor will pronpt the user to mount another cassette by printing: 

where # represents one of the drive numbers. After the user has 
mounted the new cassette the output operation continues. The files 
may later be combined under one filename using PIP {see chapter 8) . 
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■RE AX? 

The Bead command fRj causes a page of text to be read from the input 
file (previously specified In an ER commarLd) and appended to the 
current contents, if any, of the ^Text Buffer, The form of the command 
is: 

R 

No arguri^nts are used with the R coirmand and the pointer is not moved* 
Text is input until one of the followintj conditions occurs; 

1. A forf^ feed character (signifying the end of the page) 
is encountered. At this point, the form feed will be 
the last character in the buffer; or 

2. The Text Buffer is within 500 characters of being full. 
(When this condition occurs, Head inputs up to the next 
carriage return/line feed combination, then returns to 
coranand n«3de. An asterisk is printed as though the Read 
were complete, but test will not have been fully input)? 
or 

3. An end-of~file condition is detected (the *EOF* message 
is printed when all text in the file has been read into 

memory and no more input is available). 

The naximum number of charactera which can be brought into memory 
using a Read command is approximately 5,000 for an 8K system. Bach 
additional 4K of memory alloy's another 5,000 characters to be input. 
Mi error message is printed if the Read exceeds the inemory space 
available, or if no inpxit is available. 



WRITE 

The Write command (W) moves lines of text from the Text Buffer to the 

output file (as specified in the EW command). The formats are: 

nW Write all characters beginning at the pointer and 
ending at the nth CR/LP to the output file. 

-nW Write all characters beginning on the -nth line 
and terminating at the pointer to the output file, 

OW Write the text from the beginning of the current 
line to the pointer. 

/W Write the text from the pointer to the end of the 

buffer. 

The pointer is not moved and the contents of the buffer are not 
affected. If the buffer is empty when the Write is executed, no 
characters are output. 
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Examples ! 



*5WS$ Write the next 5 lines of text 

starting at the pointer to the 
current output file* 

♦-2WSS Write the previous 2 lines of text, 

ending at the pointer to the 

current output file. 



NEXT 

The Next comniand acts as both an input anct output command since it 
performs both functions. Pirat it writes the current TeKt Buffer to 
the output file, then clears the buffer, and finally reads in the next 
page of the input file, The Next coF'jnand can be repeated n times by 
indicating an argxament before the ccnnmand. The connnand format is: 

nN 

Itext accepts only positive arguments and leaves the pointer at the 
beginning of the buffer upon completion of the operation. If fewer 
than n pages are available in the input file^f all available pages are 
read in, output to the output file, and deleted; the pointer is left 
positioned at the beginning of an enpty buffer^ and an error Eiessage 
is printed. {U is equivalent to typing the ccnmand combination 
n<B/W/Dn> and pi^vides a means of spacing fortrard, in page increments, 
through the Input file,) 



Examples 



*2HSS Write the contents of the current 

Text Buffer to the output file, 
clpar the buffer and read and write 
the next page of text; clear the 
buffer and then read another page. 



LIST 



The Irlst corsnand prints the specified nunber of lines on the console 

terminal. The format of the coririand is: 

nlj Print all characters beginning at the pointer and 
ending with the nth CR/LF, 

-nil Print all characters beginning with the first 
character on the -nth line and teminating at the 
pointer. 

OL Print from the beginning of the current line up to 
tlie pointer. 

/h Print from the pointer to the end of the buffer, 

The pointer is not moved after the cor'imand is executed. 
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Examples s 

J-2LSS Print all characterH starting at 

the second preceding line and 
ending at the pointer, 

J^LSf Print all characters beginning at 

the painter and terFsinatlng at tha 
the 4th CR/LF, 

?issuning the pointer location is ais follo^fs; 

MGVB 5CR1>.»R2J ^ 

ADD ^ RltiHZl*^ i Pointer is here 

The commands 

*-lL$$ 

Prints the preceding 1 1/2 lines: 

r>40VB 5<Rn>aR&^| 
ADD 



VERIFY 

The Verify command prints the current text line (the line containing 
the pointer) on the teminal. The position of the pointer within the 
line has no effect and the pointer does not move. The command format 

is : 

V 
No arguments are used. (V is equivalent to typing OLL.) 

Example ; 

*VSS The command causers the cnrrant line 

ADD RU{Ra>+ of text to he printed. 



END FILE 

The End File command closes the current output file. This corm^and 
does no input/output operations and does not move the pointer | the 
buffer contents are not affected. The output file is closed, 
containing only that text previously output. The form of the command 

xs * 

BF 
No arguments are used in tho EF conanand. 
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EXIT 

The Exit command is ■usee! to terminate editing , copy the remainder of 
the input file to the output file, and return control to the Keyboard 
Listener (the Monitor should be entirely resident in mepiory so that a 
reboot is unnecessary) . The EXit corijtnand perforpis consecvitive Next 
connandR until the end of the input file is reached, then closes both 
the input and output files. The command format is; 

EX 

No arguments are used in the RX command. 

NCWE 

Either an EF or EX cormand is necessary 
to make an output file permanent. If a 
tC is typed prior to executing an EF, 
the current output file will not be 
saved. 

An example of the contrasting uses of the EP and BX coranands might be 
the followings assume an input file called SAMPLE (on cassette drive 
0) contains several pages of text. The user wishes to make the first 
and second pages of the file separate files called SAMl and SAM2 
respectively? the remaining pages of text will then make up the file 
SAMPLE. This can be done using the following conwiands i 

*ER0t SAMPLES* 

itwitsmns 

Wvt EF 55 
iEWItSAM2SS 

•EWlSSAMPLESEXSS 

The user might note that the EP commands ara actually not necessary In 
this example, since the EW command closes a currently open output file 
before opening another. 



4.4.7 Pointer Relocation Commands 

Pointer relocation commands allow the current location pointer to be 
moved within the Text Buffer. Several commands are available for this 
purpose. 



BEGINNING 

The Beginning command moves the current location pointer to the 
beginning of the Text Buffer. The corranand format, is; 

B 

There are no arguments. For example, assume the buffer contains t 
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!iOVB SCRlJ,«RSJi 

CLR gf jg^ I Pointer is here 

The B coirjmandt 
«BS£ 

will move the pointer to tha beginning of the Text Buffers 

tMQVB 5CRl?j8RgJ| Pointer is now hare 

ADD RiTTSiT+Ji 

CLR isej i 

NOVB 6CRl>,fRBj| 



JUMP 

The Jutmp command nxj-yes the pointer over the specified number of 
characters in the Text Buffer. The form of the command is; 

(+ or -)nj Move the pointer (backward or forward) n 
characters. 

OJ Hove the pointer to the beginning of the current 
line (equivalent to OA) . 

/J Move the pointer to the end of the Text Duffer 
{equivalent to /A) . 

«J ^tove the pointer backward n characters , where n 
equals the length of the last text argument used. 

Negative arguitsents move the pointer tov?ard the beginning of the 

buffer, positive arguments toward the end* Jump treats CR, LF and 

form feed characters as any other character, counting one buffer 
position for each. 

Examples s 

*5JSS Move the pointer forward 5 characters 

*-4J$S Move the pointer back 4 characters 

*B$QABCS=J£S Kove the pointer so that it iiKmediately 

precedes the first occurrence of 'ABC 
in the buffer. 



ADVANCE 

The Advance command is similar to the Jianp comnand except that it 

moves the pointer a specified number of lines (rather than single 

characters) and leaves the pointer positioned at the beginning of the 

line. The form of the coninand ist 
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nA Advance the pointer for^jard n lines and position 
it at the beginning of th^ n+1 line. 

~nA Move the pointer backward past n CR/LFs and 
position it at the beginning of the -nth line* 

OA Advance the pointer to the beginning of the 
current line (equivalent to J) . 

/A Advance the pointer to the end of the Text Buffer 
(equivalent to /J) . 

For example, assupie the buffer contains: 

CLR 9R^ I Pointer is here 

The copwiand! 

*0ftSS 

Moves the pointer as follows: 

iCtR aRgJ I ^Pointer is nobr here 



4,4.8 Search Coninanrts 

Search commands are used to locate specific characters or strings of 
characters within the Text Buffer, 



GEI" 

The Get command is of tlie formt 

nGtext$$ 

and searches the current Text Buffer startinq at the pointer for the 
nth occurrence of the text strin^i. If the search is successful, the 
pointer is left immediately follm-^ing the nth occurrence of the text 
string. If the search fails, an error message is printed and the 
pointer is left at the end of the Text Buffer. 

The argument must be positive and is assumed to be 1 if not otherwise 
specified. The text string may be any length and immediately follows 
the G command. The search Is made on the portion of the text between 
the pointer and the end of the buffer. 
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Examples 

Assuming the buffer contains . 



MOV 


PC*R| 


ADD 


#0R|V-.,R1 


MlOV 


#VECT,Ra 


ca,R 


•R2, I 


MOVS 


5CRt)>9R2 


ADD 


R)^<R2>» 


ca-R 


9R2 


movb 


6<RI)*iRS 



Pointer is here 



The coMinandj 

*BGAOD$$ 

poaitlons the pointer as follm-fst 

APP j #PRIV-»*Rt Pointer is here 
The conmand: 

*3S#Ra$S 

positions the pointer: 



ADD 
CLR 



R1,CR2?* 
•H2. 



Pointer is here 



after search coitsnands, the pointer is left irwiediately following the 
text object. Using a search cojnmand in connection witli »J will place 
the pointer before the text object, as follovj's: 

4G0ejlS=JIS 
The pointer will now be placed imr^diately before 'OBJl': 
IMC /38J 1 Pointer is here 



FIND 

The form of the Find connand is: 

nFtext$$ 

Starting at the pointer, this coimand searches through the entire text 
file for the nth occurrence of the character strintj specified in the 
command. It combines the Get and Next cornnandK such that if the 
search is not successful in the current buffer, the contents of the 
buffer are output to cassette, the buffer contents are then deleted, a 
new page is read in, and the search is continued. This will proceed 
ijntil either the search string is found or until the complete source 
text has been searched. If the search is successful, the pointer is 
left iinmediately following the nth occurrence of the text string. If 
the search fails (i.e., the end-of-fllei is detected for the input file 
and the nth occurrence of the text string has not been found), an 
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error nisssage is printed anfl the pointer is left at the beginning of 
an empty Text Buffer. (By deliberately' specifying a non-existent 
search string^ the usfsr can close out hLs file; that is, he can copy 
all renalnlng text frcn the input cassette to the output cassette.) 

The argument iriust he positi^re and ±» assioned to be 1 if not otherwise 
specified. 



Example : 



*2FM0VB 6£Rl}*iR£SS Search the entire input file for 

the second occurrence of the text 
string HOVn 6(Rl),^n2. Each 
unsuccessfully searched buffer is 
written to the output file. 



POSITION 



The Position coFnand searches the input file for the nth occurrence of 
the text string. If the text string is not found, the buffer is 
cleared and a nev? page is read from the input file. The format of the 
connand is ; 

nPtextS 



The argunent 

specified 
buffer are b 
buffer. If 
new page of 
betv/een the 
contents of 
deletes the 



must be positive, and is assuned to be 1 if not otherwise 

WnBR a P conmand is executed, the current contents of the 

earched fron the location of the pointer to the end of the 

tlie search is unsuccessful, tha buffer is cleared and a 

text is read and the cycle is continued. (The difference 

Find and Position commands is that Find t-?rites the 

the searched buffer to the output file while Position 

contents of the buffer after it is searched,) 



If the search is successful, the pointer is positioned after the nth 
occurrence of the text. If it is not, the pointer is left at the end 
of an empty buffer. 

Example: 



♦PADD RI,CR2>*SS 



Search the entire input file for 
tJie string ADD Rl,(n2)+, deleting 
imsuccess fully searched buffers. 



4.4,9 Text Modification Conmands 

The following cotnnands are used to insert, relocate, and delete text 

in the Text Buffer, 



IHSERT 

The Insert command catises the Ilditor to enter Text Mode and allows 

text to be infierted Innediately following the pointer. Text is 
inserted until an MiTflonr is typod and the pointer is positioned after 
the last character of the insert. The eornand fomat is: 
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Itext$ 

No arguments are used in the Insert eoFinancI and tlin text string is 
limited only J>y the sise of tJie Text Buffer and the space available. 
All characters encept ALT?!ODE are legal in the text strin<3. 

EDIT automatically protects against overflowing the "Text Buffer during 
an Insert, If the I corananfl is the first coF.inanr[ in a repetitive 
conmand line, EDIT ensures that there will be enough space for the 
Insert to be executed at least once. If repetition of the conmand 
exceeds the available rnemory, an error message is printed. 



Example; 



ilMOM #BUFF*R2 
MOV *LlHt*nt 
H0V8 -HRg>,R0 

ss 

1 



Insert the specified tent at 
tlie current location of the 
pointer afid leavo the pointer 
positioned at the beginning oJ 
the line following RO. 



The Delete coxranand removes a specified nuinl>er of characters from the 
Text Buffer. Characters are deleted starting at the pointer? upon 
completion of the copmand, the pointer is positioned at the first 
character following the deleted text. The form of the coFimand isi 

(-f or -)nD Delete n characters (forward or backward from the 
pointer) , 

OD Delete fror. beginning of current line to pointer 
(equivalent to OK} . 

/D Delete from pointer to end of Text Buffer 
{equivalent to /K) . 

=D Delete -n characters, where n equals the length of 
the last text argument used. 



Examples s 

♦BfFMOV RISsDS 
Assuming a buffer of: 



ADO 

ca.R 



,eRe 



lifelete the two characters 

immediately preceding the pointer. 

Delete the text string 'MOV Rl. ' 
(*=D u^ed in conjiinction with a 
search command will delete the 
indicated text string) 



Pointer is here 
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The conmand: 

*0DSS 

leaves the buffer with; 



ADD Rl,tR2)+ 

i*R2 Pointer is here 



KILL 

The Kill conmand removes n lines from the Text Buffer, Lines are 
deleted starting at the current location pointer; upon completion of 
the coPUTiand, the pointer is positioned at the beginning of the line 
following the deleted text. The comirianct format is : 

nK Delete lines beginning at the pointer and ending 
at the nth CR/LP. 

-nK Delete lines beginning with the first character in 
the -nth line and ending at the pointer. 

OK Delete fron the beginning of the current line to 
the pointer (equivalent to OD) . 

/K Delete fron the pointer to the end of the Text 
Buffer (equivalent to /D) . 



Example : 



*2KS5 Delete lines starting at the 

current location pointer and ending 
at the 2nd CR/LF. 



Assuming a buffer of; 



ADD 


R]*(R2>-f 




CLR| 


9R^ 


Point 


NOVB 


6CR1)*»R2 




The command; 






i/KSS 






Alters the contents of the 


buffer to: 


ADD 


R1,CR2) + 




CLR, 




Point 



CHANGE 

The CHANGE command replaces n characters, starting at the pointer, 
with the indicated text string and leaves the pointer positioned 
imnediately following the changed text. The format of the command is: 
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{+ or -}fiCtext$ 



OCtext$ 



/Ctext$ 



'»1^'(^6XC •jt 



replace n characters {fon^^ard or backward 
from the pointer) with the specified text. 

Replace all characters from the beginning of 
the line up to the pointer with the specified 
text. (Equivalent to OX) 

Replace all characters from the pointer to 
the end of the buffer with the specified 
text. (Equivalent to /X) 

Replace -n characters with the indicated text 
string, where n represents the length of the 
last text argument used. 



The size of the text is United only by the size of the Text Buffer 
and the space available. All characters are legal except ALTMODE 
which terminates the text string. 

If the C command is enclosed within an<jle brackets so that it will be 
executed niore than once, and if there is enough space available so 
that the command can be entered, it will be executed at least once 
(provided it is first in the eowmand string) . If repetition of the 
ccmmand exceeds the availalile memory, an error s^ssage is printed. 



Example : 



*5C#VECTSS 



Replace the 5 characters to the 
right of the pointer with IVKCT, 



»C can be used in conjunction with a search 

specific text string as follows s 



command to replace a 



♦GFIFTY: S=CFI VE! S find the occurrence of the text 

string FIFTY and replace it with 
the text sstring PIVK, 



Assuming a buffer of: 



MOV| SCRUjgRg Pointer is here 



The ccsnmand: 

*0CADDBSS 

Leaves the buffer with! 



CLR »R2 

ADO ^ 5cniif9R2 pointer is here 



Typing nCTEXT$ is equivalent to typing -n01TEXT$ . 
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EXCHANGE 

The Exchange command replaces n lines, beginning at the pointer, with 
the indicated text string and leaves the pointer positioned after the 
changed text. 

The form of the command is : 

nXtext$ Replace all characters beginning at the 
pointer and ending at the nth CR/LF with the 
indicated text. 

-nXtext$ Replace all characters beginning with the 
first character on the -nth line and ending 
at the pointer with the indicated text. 

OXtext$ Replace the current line from the beginning 
to the pointer with the specified text. 
(Equivalent to OC) 

/Xtext$ Replace the lines from the pointer to the end 
of the buffer with the specifed text. 
(Equivalent to /C) 

All characters are legal in the text string except ALTMODE which 
terminates the text. 

For example, assuming a buffer of: 

ADD ,R|j(Ra?-f 

CLR eR2 Pointer is here 

The command : 

•XR1*CR3>+ 

replaces the text to the right of the pointer (on the current line) 
with the indicated text. 

If the X command is enclosed within angle brackets so that it will be 
executed more than once, and if there is enough memory space available 
so that the X command can be entered, it will be executed at least 
once (provided it is first in the command string) . If repetition of 
the command exceeds available memory, an error message is printed. 



4.4.10 Utility Coimnands 

The memory area used by the Editor is divided into logical buffers as 
follov/s I 
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MACHO BUFFER 



SAVE BUFFER 



FRI^E MEMORY 



COMMAND INPUT 
BUFFER 



TEXT BUFFER 



High Memory 



how Memory 



The Text Duffer contains the current page of text being edited and 
the Command Input Buffer holds the conmand currently being typed at 
the terminal. Both of the5se buffers have been previously mentioned* 

The Save Buffer contains text stored with the Save (S) command and the 
Macro Buffer contains the command string macro entered with the Macro 
(M) coFjnand (each are explained next). The Macro and Save Buffers are 
not allocated space until an M or S conmand is executed. Once an M or 
S copmand is executed, a OM or OU (Unsave) conwancl must be eKecuted to 
return that space to the free area. 

The buffers expand and contract to accomodate the text being entered. 



viftv tj 



The Save cominand copies a specified number of lines starting 
pointer into the Save Buffer, The forn of the command isi 



at the 



nS 



The argument (n) must be positive. The pointer position does not 
change and the contents of the Text Buffer are not altered. Each time 
a Save is executed, the previous contents of the Save Buffer, if any, 
are destroyed. If the Save command causes an overflow of the Save 
Buffer, an error message is printed. 



Example! 

Assuming the Text Buffer 
subroutine : 



contains the following assembly language 



I SUBROUTINE MSGTYP 

IWHE^ CALLED, EXPECTS R0 TO POINT TO AN 
lASCIl MESSAGE THAT ENDS IN A ZERO EffTE 
I TYPES TKAT MESSAGE ON THE USER TERrtlNAL 



MSGTYP: TSTB CX0> 

BEQ «0OMt 
MLOOPs TSTB t#17?S64 

BPL MLOOP 

MOVB CJIBJ+# if 177566 

BR MSGTYP 
MDONEi RTS PC 



I DOME? 

lyeS-RETUBW 

»N0-1S TiRMINrt. READY? 

* NO-WAIT 

* YES- PRINT CHARACTER 
JLCSOP 

J RETURN 
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The command J 

stores the entire subroutine in the Save Buffer; it may then be 
inserted in a progran vj'henever needed usin^r the U corimand. 



UN SAVE 

The Unsave camand inserts the entire contents of the Save Buffer into 
the Text Buffer at the pointer location ant! leaves the pointer 

positioned following the inserted text. 

The form of the command is: 

U Insert the contents of the Save Buffer Into the 
Text Buffer. 

OU Clear tlie Save Buffer and reclain the area for 
text. 

Zero is the only legal argument to the U conmnnd. 

The contents of the Save Buffer are not destroyed by the U connand 
(only by the OU comrtand) and may be Unsaved as many times as desired . 

If the Unsave command causes an overflow of the Text Buffer, an error 
message is displayed. 



The Macro coronand inserts a connand string into EDIT's Macro Buffer, 
and is of the form; 

M/comnand string/ Store the connand string in the 

Macro Buffer 

OM Clear the Macro Buffer and 

or M// reclain the area for text 

/ represents a delimiter character. The delimiter is always the first 
character follot^ing the M connand and may be any character which does 

not appear within the .'-tecro comraand string itself. 

Starting with the character follovring the deliniter, EDIT places the 
Macro coranand string characters into its Internal Macro Buffer until 
the deliniter is encountered again. A douJ^de ALTMODE then returns 
EDIT to Comraand Mode, The Macro comjnand does not execute the Macro 
string; it merely stores the comnand string so that it can be executed 
later by the Execiite Macro (Rl'l) command. Macro does not affect the 
contents of the Text or Save Buffers, 

All characters except the delimiter are leflal Macro ccmmand string 
characters, including single ALTFKlDE's to tenninate text commands. 
All commands except the H and RM Commands are legal in a Macro command 
string. 
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In addition to the OM conmand, typing the M command immediately 
followed by two identical characters (assumed to be delimiters) and 
two ALTHODE characters also clears the Macro Buffer. 



ExaF.ples : 



jM//S» or 
*M/BGR0$-CtS/5S 



Clear the Macro Buffer 

Store a Macro to chanae RO to Rl 



EXECUTE MACm 

The Execute Macro command executes the connand string specified in the 
last Macro comiiand and is of the form; 

nEM 

The Macro is executed n times and returns control to the next command 
in the original command string. 

The argument must be positive. 

Examples; 

j|B1000EH$$ Executfi the Macro stored 

?*SRCan FftIL in MACRO*? in the previous example. 

An error message is 
rettirned when the end of 
buffer is reached. (This 
Macro effectively changed 
all occurrences of RO in 
the Text Buffer to Rl. } 

In a naw program, insert 
MOV PC,R1, then execute 
the cGnmand string in the 
Macro Buffer twice before 

inserting CLR iR2. 



• IMOV PC»RlSgeiICLR »R2$S 



4,5 ERROR MESSAGES 

The Editor prints an error message whenever one of the error 
conditiona in Table 4-3 occurs. Prior to executing any commands, the 
Editor first scans the entire command string for syntax errors (format 
errors such as illegal arguments, illegal combinations of cor^mands, 
etc.). If an error of this type is found, an error message is printed 
in the following fomati 

?ERROR MSG7 

and no commands are executed; the user must retype the command. 
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If the conmand string contains no syntax errors, execution is started; 
however, errors during execution are also possible (buffer overflow, 
I/O errors, etc). If an error is found at during execution, a message 
of the fom: 

?*ERROR I^G*? 

is printed. In this ca!=!e, all commands preceding the one in error 
will have been executed? the comnancl in error and those following will 
not be executed, ^tost errors will generally be of the syntax type and 
can be corrected before execution. 

When an error occurs during execution of a Macro, the message format 
?*message IH MACRO*? 



Table 4-3 
EDIT Error Messages 



Message 


Explanation 


?-<>"ERR? 


Too deep nesting or illegal use 
of brackets, or unnatched 
brackets. 


* CB ALMOST PULL * 


The connand currently being 
entered by the user is within 10 
characters of exceeding the space 
available in the Coranand Buffer 
{see Section 4,4,2), 


?CB FULL? 


Command exceeded the space 
allowed for a conmand string in 
the Coramand Buffer, 


?*EOF*? 


Attempted a Read or Next coimiand 

and no data was available. 


?*PILE NOT POttTO*? 


Attempted to open a nonexisting 
file for editing. 


?*HDW ERR*? 


A hardware error occurred during 
I/O. 


PILL ARG? 


The argument si^ecified was 
illegal for the conmand used. A 
negative argument was specified 
where only a positii/e argument 
was allowed, or an argunent 
exceeded the range •¥ or -16384. 


?iLL am? 


EDIT does not recognis^e the 

conrsand specified. 



(Continued on next page) 
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Table 4-3 (Cont.) 
EDIT Error Messages 



Message 



Explanation 



?ILL MAC? 



?*ILL NAMK*? 



?*I/0 CHAN CONFLICT* 



?*N0 FILE*? 



?*N0 ROOM*? 



Delimiters wern improperly used, 
or an attempt was made to enter 
an M command during execution of 
a Macro, or an attempt was made 
to execute an EM command while an 
EM was in progress. 

The fileneirie or device specified 
in cUi EW or ER command is 
illegal. 

An attempt was made to open an 
input file on a cassette already 
open for output, or vice versa. 



?*SRCH FAIL*? 



?*TAPE FULL*? 



Attempted to Read or Write 
no I/O file was open. 



when 



Attempted to Insert, Save, 
Unsave, Read, Next, Change or 
ExchcUige when there was not 
enough room in the appropriate 
buffer. 

The text string specified in a 
Get, Find or Position command was 
not found in the available data. 

Available space for an output 
file is full {i.e., there is no 
room for any part of the output 
file). 



4.6 EXAMPLE USING TJIE EDITOR 

The following example illustrates the use of the Editor to change a 
program which is stored on cassette drive 0. Sections of the printout 
are coded by letter and corresponding explanations follow tlie example. 
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".R EDIT 

A {♦ERBtTESTl.PALSX 

♦ EWltTESia.PALSS 

J TEST PROGRAM 

PC«Z7 

.GLOBL MSGTYP 
STARTj NOV #1000, t6 J INITIALIZE STACK 

NOV #MSG*X0 *P0lr4T R0 TO MESSAGE 

B< JSR pcmsgtyp iprimt it 

HLT t STOP 

MSB* .ASCII /IT WORKS/ 

.BTCTE 15 

.iYTE 12 

.BYTE 
C ^*8lJ50t$ 
fj /*SPROGRAMSVS* 

I J PROGRAM 

'♦1 TO TEST SUBROUTINE MSGTYP. TYPES 
i'*THE TEST PRCKiRAM MO»<S" 
ION THE COMSOXOSIXMSOLE TZmiHH. 

^m 

f ^*F.ASCII /$8CTHE TEST PROGRAM WORKSSS 

«#P.SYTEtU 
G {♦r.BYTE 0tV$S 
I .BYTE 

(*l 

.END 

I PROGRAM TO TEST SUBROUTINE MSGTYP. TYPES 
I "THE TEST PROGRAM WORKS" 
JON THE CONSOLE TERMINAL 



H i 



PC«X7 

.GLOBL MSGTYP 
START* MOV #1000*%6 i INITIALIZE STACK 

MOV #MSG#X0 J POINT R0 TO MESSAGE 

JSR PC*MSGTYP J PRINT IT 

MLT I STOP 

MSGt .ASCII /THE TEST PROGRAM WORKS/ 

.3YTE 15 

.eVTE 12 

.BYTE 

.END 



J* 

i: 



B6HLT$«CHM.TSV$$ 

HALT J STOP 

mm 
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A The EDIT program is called and prints an *, The input file is 

TESTl.PAL on drive 0, and the output file is TEST2.PM, on drive 
I J the first page of input is read. 

B The buffer contents are listed. 

C Be sure the pointer is at the beginning of the buffer. Advance 
the pointer 1 character (past the ;) and delete "TEST ", 

D Position the pointer after PROGRAM and verify the line; the 

pointer is not moved. 

E Text is inserted. ftOBoUT is used to correct a typing error. 

F Search for .ASCII / and change "IT WORKS" to "THE TEST PROGRAM 

G CTRL/U is typed to cancel the P corwand. the P command is then 
used to search for .BYTE and verify the location of the pointer 

with V coramand, 

H Insert text. The pointer is returned to the beginning of the 
buffer and the entire contents of the buffer are listed. 

I The user notices that HALT is spelled incorrectly^ makes the 
change and verifies it. 

J The input and output files are closed after copying the current 
Text Buffer as well as the rest of the input file into the output 
file. EDIT returns control to the Monitor, 
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CHAPTER 5 
ABSEMBLIKfi THE SOURCE PHJGRAM 



The. CAPS-11 flssenJiler is a two pass asisenbler (witJi an optional third 
pass) which allc«7s tha user to create a binary object file from a 
source progran. In the first two passes, the source program (which is 
generated on-line using the Editor) is trannlated into an object 
module which may contain both absolute and relocatable code. 
Separately assembled object modules may reference one another using 
special symbols called global sypiJsols. object modules are then 
processed by the Linker, producing a load module which nay be loaded 
into neroory and executed (the linking process is explained in Chapter 
6), During the second (or tlae optional third) pass, the Asseribler 
produces a complete octal/syrt>olic listing of the assemfjled program. 
The listing if? especially useful for documentation and debugging 
purposes. 

This chapter not only explains ha%-i to write PAL asseribly language 
prograBJs, but also how to assemlile the source prograns into object 
modules. In explaining how to write source programs it is necessary, 
especially at the beginning of the chapter, to make frequent forward 
references. The user should first read through the entire chapter to 
get a "feel" for the language, and then reread the chapter^ this time 
referring to appropriate sections as indicated in order to gain a 
thorough understanding of the language and asserit>ling procedures. 

It is assumed that the user is familiar with the POP- 11 PROCESSOR 
HANDBOOK and tlie PDP-ll PKRIPHEimLS ANB INTERFACING HANDBOOK, with 
enphasis on those sections which deal with the PDP-11 instruction 
repertoire, fortnatS|. and tinlngs; a thorough knowledge of these is 
vital to efficient assembly language programming. 



5.1 CALLING AND USING THE ASSEMRMR 

The Assembler Ln called from the System Cassette by typings 

^R PAL 

In response to the dot printed by the Keyboard Listener. The Command 
String Interpreter responds by printing an asterisk (*) at the left 
margin indicating that it is ready to accept input/output 
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specifications. The user nay enter his command line followed by a 
carriage return even though the remainder of PAL is simultaneously 
being loaded into memory . 



5,1.1 Assembler Options 

The options listed in fatjla 5--1 are valid for use with the 
and are indicated by the user in the I/O specification line, 



Assembler 



Table 5-1 
PAL Options 



Option 



Meaning 



/c 



/p 



/o 



/p 



This option allows an I/O specification 
line to be broken into several segments. 
The option character is followed 
imrmdiately by a carriage return and the 
command string is continued on the next 
line? this next line must begin with a 
Gorma. 

This option is valid only after an input 
filename and specifies that the Assenbler 
should not perform a REWIND operation btjt 
should continue searching the cassjette in 
a forward direction for this file. The /F 
feature saves the user tine when he wishes 
to input several files from one cassette 
and these files appear on the cassette in 
the sarne order as they are to be 
assembled. The /F option prevents the 
Assembler from performing a REWIND before 
accessing each file. 

This option is valid only after an output 
filename and indicates that the file 
(ii«imediately preceding the option) is to 
be created and used only if a previously 
opened output file has been written to the 
end of the cassette and more output 
remains. Ml output files should later be 
combined under one name using PIP <see 
Chapter 8). 

This .option is used whenever a file 
referenc6^d in the I/O specification line 
exists on a cassette which is not 
currently rrounted on a drive. Before 
attempting to search for the file, the 
Asseml)ler instructs the user to mount the 
proper cassette on the drive by printing 
t? where # represents the drive number. 
After the user has switched cassettes on 
the drive, he may continue execution by 
typing any character on the keyboard. 



(Continued on next page) 
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jf 'V 



z^- 



Table 5-1 (Cont. ) 
PAL Ot>tions 



Option 


Meaning 


/x 


This option is valid only after an output 
filename and causes extended binary output 
(i.e., those locations and binary contents 
beyond the first binary word per source 
statenent) to be suppressed from the 
listing. 



5.1.2 Input and Output Specifications 

Input and output specif icntlons are typed by the user in responise to 
the asterisk printed by PAIj. The fomat of the command string ist 

*DKV;FILE . BIN/OPT, DKViFILF:. LKT/OPT=DBV:INPOT. 1/C 
,DEVs INPUT. 2/OPT , , . . DEV: INPUT. n/OPT 

DSV represents the device, PILK.BIN represents the binary output file 
and FILE.LST represents the listing output file. Null output of 
either the binary or listing file is represented by a single comma in 
the connand line. For example : 

• l:F[LE.BIN*»I(^PUT.PAL 

causes only the binary file to be produced. Any ntmber of input files 
{INPUT. 1. ., INPUT. n) is permitted. OPT represents any one (or more) of 
the options listed in Talile 5-1. 

If both the binary and listing output files are to be sent to 
cassette, the Assertjler will require three passes since it cannot 
output these two files simultaneously. Otherwise only t%»ro passes are 
required. 

Under an 8K system, control returns to the I-fenitor following the 
assembly process; under systeris greater than SK^ control returns to 
the CSI, indicated by an asterisk, and the user can enter another 
coiivmand line. 



5.1.3 Restarting the Assembler 

The Assembler may be restarted at any tine {while it is in memory) by 
typing CTRL/P. This echoes as '^P on the console terminal and is 
followed by a carriage return/line feed. Note that this restarts the 
Assembler but does not always allow the user to input a new command 
string. In 8K systems, the Cfil has been overlaid by the Assenbler and 
cannot be accessed; therefore, typing CTHL/P will restart the assembly 
already in progress. In larger systems, the CSI is not destroyed and 
typing HP* while PAI* is running will alln^ the user to enter a new 
command string. 
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5.2 CHARACTEK SET 

The following ASCII characters are used in writing a PAL source 
program (see Appendix A) : 

1. The letters A thrniigh Z. (Both upper and lower case letters 
are acceptaljle, although lovjer case letters will be converted 
to upper case letters upon input. ) 

2 . The numbers through 9 . 

3. The following separating or terminating symbols s 
: = %#^() ,;''♦+-&! 
carriage return tab space line feed forn feed 

4. The characters . and $ are valid but are generally reserved 
for use by syst^n <?oftware. 



.5,3 STATEMENTS 

A PAL source program is coFiposed of a sequence of statements, each on 
a single line terminated by a carriage return/line feed (CS/LF) or 
carriage return/form feed combination, 

NOTE 

Since the carriage return is a required 
staterient terminator, the Assembler 
inserts a carriage return before any 
line feed or form feed not imnediately 
preceedad by one. If the CAPS-11 Editor 
is tised to create the source program j 
any carriage return typed by the user 
automatically generates a line feed 
character. 

The statement itself nay be composed of as many as four fields which 
are identified by their order of appearance and by specific 
terminating characters. The four fields are catagorlzed as: 

Labels Operator Operand fComptent 

The label and comment fields are optional. The operator and operand 
fields are interdependent; that is, either one may be omitted 
depending upon the contents of the other. 



5.3.1 Labels 

A label is a aytnholic name created by the programmer (see Section 
5.4.2) to identify the location of a statement in the program. It 
always occurs first in a statement and must be terminated by a colon. 
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It is assigned the valuB of tha assembly location counter (see Section 
5.5.4), which nay be eithfir a;>golute (fixed in menorv independently of 
the position of the progran) or relocatable (not fixed in meinory) , 
For example, if the current asserhly location is absolute 100 (octal), 
the statftnent! 

ABCDs MOV A»B 

will assign the value 100 to thti lah«ii ABCD; snhaeqwant reference to 
ABCB VTill be to location 100. 

In the above case if the assembly location counter were relocatable, 
then the final value of ABCD would he 100 (octal) plu;3 a value assigned 
by the Linker when it relocates the code, called the relocation 
factor, (The final value of ABCn would therefore not Lr known until 
link-tipie. This is explained in Sections 5«6 and 5.8.3 of this 
chapter, and In Chapter 6), 

More than one label may appear within a label field in which case each 
label within the field will have the sana valxie. For example, if the 
current location counter is 100 (octal), the statement: 

ABCl $0D! A7.7E MOV A*B 

will assign each of the three labels ABc, $DD, and Al.l the value 100 
(the characters $ and , deBignate that these labels are used in 
system software) , 

A label may be conposed of more than six characters, but only the 
first six are recognized by the AHsem}>ler, An error code will be 
generated during assembly if two or more labels have the same first 

six characters. 



5,3.2 Operators 

hn operator follows the label field in a statement and may be an 
instruction mneraonic or an assembler directive (the instruction set is 
discussed in the PDP-11 PWKESSOR MAMDBOOK; Section 5.8 of this 
chapter provides information concerning assernbler directives). When 
the operator is an instruction mnemonic. It specifies an action to be 
perfomed on any operand (s) which follows it. When It is an assembler 
directive, the operator specifies a certain function or action to foe 
perfomed during the asseinhly process. 

An operator may be preceded only by labels and may be followed by one 
or more operands and/or a connent. An operator is legally terminated 
by any of the following characters: 

line feed form feed carriage return space tab 

(The use of each of these characters will be explained later in the 
chapter.) For examples 
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JMP 



BEGIN 



JCTAB) TERMINATES OPERATOR JHP 



HOV0A>B 



J§ TERMINATES OPERATOR HOV 



When an operator is not followed by an operand or a eomnent, it is 
terminated by a carriage return followed by either a line feed or form 



5.3,3 C^erands 

Mi operand is that part of the statement which is acted upon by the 
operator and may be a symbol, expression, or nimhar. Multiple 
operands are separated frcKn one another by a comma. For ejcamplei 



LASa.! MOV R0#R1 



JTWIS IS A COMMENfT 



The space between MDV and RO terminates the operator field (MOV) and 

begins the operand field? the comma separates the operands RO and Rl. 

When the operand field is not fol loved by a coiiment, it is terminated 

by a carriage return followed by a line feed or form feed character. 
An operand is separated from a comment by a semi-colon » 



5.3,4 Comments 

The comment field is optional and may contain any ARCH character 
except null or rtibout; all other characters are ignored by the 
ABsenbler when used in the comrrLent field. 



The comnent field may be preceded by any or all 
fields, or it may be on a line by itself 
semicolon and end with a carriage return followed by a 
form feed character. For example; 



of the other three 
It must begin with a 



LABEL! CLR HERE 



I THIS IS A COMM&IT 



Comments do not affect assertbly processing or program execution, but 
are useful in program listings for later analysis, checkout or 

documentation purposes. 



5.3,5 Format Control 

The format of an assembly listing is controlled by the space and tab 
characters. These characters have no effect on the assembly process 
of the source program unless they are einbedded within a symbol, 
number, or ASCII text, or unless they are used as the operator field 
terminator. They are generally used in the source program to pKJvlde 
a neat readable listing. For example, a statement can be written j 

LABEL!MOVfSP>*jTAGjl POP VALUE OFF STACK 



This statement is correct and will assemble properly, 

the forraat control characters it can also be written; 



However, usfing 
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LABELS MOV <SPJ+,TAG J POP VALUE OFF STACK 

which is much easier to read. 

Page sisse is controlled by the fom feed character (CTTRli/L) , A page 
of n lines is crsated bi' inserting a form feed after the nth line. If 
iio fom feed is present, the Assembler autrarsatically terminates a page 
after 56 lines of text. 



5.4 SYOTOLS 

A symbol is a string of alphanumeric characters and may be any length. 

However, the Assemhler only recognlB^es the first six characters? thus 
symbols which contain the same first six characters are considered 
identical. There are two types of symbols, pernanent and 
user-defined. 



5,4.1 Permanent Symljols 

The Assenihler contains a table (called its perFianent symbol table) 
which lists the s^inhols for all instruction itineptonics and assembler 
directives. The value of a pernanent symbol is unique and independent 
of the program's position in memory. That is, its value Is fixed and 
need not be redefined by the prograFSFier. Appendix B provides a list 
of all permanent syFibols in the CAPS-ll Assertfcler, 



5.4,2 User- Defined Sywbols 

All symbols not already defined in the Assembler {and therefore 
represented in its permanent symbol table) must be defined by the 
programmer within the source progra^i. These user-defined symbols are 
those either designated as labels or created by direct assignment (as 
explained in the next section) , User-defined symbols are added to the 
permanent symbol table as they are encountered during the first pass 
of the assembly; they may be composed of alphanumeric characters, 
dollar signs, and periods only (again $' s and ,'s are usually reserved 
for system software). Any other characters are illegal and, if used, 
will result in an error message. The following rules also apply to 
use r-de f i ned s y mb o 1 s ; 

1. The first character must not be a nupiber. 

2. Each symbol must he unique within the first six characters. 
A symbol may be written with more than six characters but 
the seventh and subsequent characters are only checked for 
legality and are not otherwise recognized by the Assembler, 

3. Spaces and talss must not be imbedded within a sypJaol. 

A user-defined symbol may duplicate a permanent symbol; the value 
associated with it depends upon its use as follows: 
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1. A permanent symbol encountered in the operator field is 
always assigned its pre-defined value. 

2. A permanent symbol encountered in the operand field is 
assigned its pre-defined value unless this value has been 
re-defined by the user; in that case, it is assigned the 
user-defined value. 

User-defined symbols may be of two types — global or internal. Global 
symbols are used to provide links between object modules and are 
explicitly specified as global using a special assembler directive 
(see Section 5.8.2). A global symbol may be defined by the user (by 
either direct assignment or as a label) , in which case it is called an 
entry symbol or entry point; such symbols may be referenced by other 
assemblies or object modules. A global symliol which is not defined in 
the current assembly is called an external symlaol and must be defined 
(as an entry symbol) in another assembly. 

All other user— defined synbols are termed internal; these symbols are 
referenced only from within the current assembly. 

Under an BK system, the Assemiiler provides space in its symbol table 
for approximately 240 user-defined symbols; a 12K system has room for 
approximately 880 user-defined symbols, and a 16K (or greater] system 
allows more than 2000 U55er-defined svmliols. 



5.4.3 Directly Assigning Values to Symbols 

A direct assignment statement assigns a value to a symbol. The 
newly-defined symbol is then added to the Assembler's permanent symbol 
table; no word is reserved at the address where the definition occurs. 
The format of the statement is: 

SYMBOL=EXPRESSION 

where the expression is another symbol, numeric value, operator, or 
other expression as defined in Section 5,5, 

The following conventions apply: 

1, TUi equal sign (=) must separate the symbol from the 
expression defining the symbol. 

2, A direct assignment statement may be preceded by a label and 
may be followed by a comment. 

3, Only one symbol may be defined by any one direct assignment 
statement. 

Examples of direct assignment statements follov7: 

ft=l J THE SYMBOL A IS EQUATED 

J WITH THE VALUE 1 
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e='A-lilMASKLOW I THE SYMBOL B IS EQUATED WITH THE 

* VALUE OF THE EXPRESSION ( • A- 1 *MASKLOW) 



C* D»3 I THE SYMBO. D IS EQUATED WITH 

E: MOV «t#ABL£ >THE VALUE 3. CSINCE t40 WORD IS 

; RESERVED, LABELS C AND E ARE 
fBOTH EQUATED HI TM THE fslUMERICAL 
; MEM DRY ADDRESS OF THE NOV COMHAMD) 

A syFiliol piay be rodefine*d liy asaignincf it a new valiief the new value 
will replace tlM old value in the pemanent syr^ol table, 

UOTT. 

If the dGf.lninq expreBsion is a global 
syRbol, the defined symbol will not be 
global imless it has previously been 
defined as such (see Section 5,5)* 

Only one level of forward referencing is allov^ed in a direct 
assignment statement. That is, the following arrangement is illegal^ 

X»Y 
Y»Z 
2;>300 

In a case svich as this, X and Y will both be undefined throughout pass 
1 of the a.sserjjly and will be listed as such at the end of that pass. 
Y will he defined during pass 2, but X will remain undefined 
throughout tliat pa^^g and will generate an error message following the 
pass. 

A syFijol XFs relocatable or absolute depending upon, the mode of the 

defining ejcpression. Beet ion 5.5.5 explains ho^^-- to determine the itiode 
of an expression. 



5,4,4 Register SyraJiols 

The eight general registers of the PDP-11 are numbered through 7, 

The programmer may assign syrJ^olic nanes to these registers and 
thereafter reference then as synbols. 

A register sytnlwl is defined by means of a direct assignment statement 
where the defining expression contains at least one term (that is, 
synbol or numeric value) preceded by a % sign, or at least one term 
(symbol or numeric value) previously defined an a regi.qter symbol. In 
addition, the defining expression of a register symbol must be 
absolute. Por example: 

m=tB I DEFINE R0 AS REGISTER 

R3»R0*3 I DEFINE R3 AS REGISTER 0+3 
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R4-l*t3 J DEFINE RA AS REGISTER 3 * 1 

THERE»X2 J DEFINE "THERE" AS RESISTED 2 

It is Important to note that, all register syinhols must be defined 
before they nay be referenced. Any reference to an undefined register 
symbol will generally cause errors. 

After a register symbol has been defined, any expression containing a 
I sign indicates a reference to a register? such an expression is 
called a register expression. Thus, the statement: 

a,R Z6 
indicates that register 6 will be cleared, whiles 

CUR 6 

will clear the word at r^mory address 6. 

In certain cases a registeE can be referenced without the use of a 
register sypibol or register exfsression. These cases &r& recognized 
through the context of the statement and are explained in Sections 
5.7,13 and 5.7.14, 



5.5 EXPRESSIONS 

Expressions are formed by the combination of terns. Terms may be 
synbols, numbers, ASCII data, or the present value of the assembly 
location counter (aa represented by the special character, period) and 
are joined to one another by logical or arithnetic operators. A 
single terra may form an expression, or several terms may be combined 
by operators to make up the expression. (Syiabols have already been 
explained? the remaining terms are covered in this section.) 

Ejqjressions are evaluated by the Assembler from left to right and are 

assigned word locations? parenthetical grouping is not allowed. •The 

evaluation of an expression includes the evaluation of the mode of the 

resultant expression (i.e., a.hsoliite, relocatable, or externali see 
Section 5.5.5.) 

In evaluating expressions, the Asseinbler will interpret the following 
illegal conditions as indicated: 

1. A missing term, expression or external symbol will be 
interpreted as 0. For example: 

M-100 iOPERA^^D MISSING 

will be evaluated as A+o-100. 

2, A missing Of^rator will be interpj^ted as + . For example: 

TAG f LA 177777 1 OPERATOR MISSINS 

will be evaluated as TAG ! LA+1?7777| an error code will be 
printed* 
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3, The value of an external expression (one which contains a 
syml>ol not defined in the current program) will be the value 

of only the absolute part of the expression; e.g., EXT+A will 
have a value of A. (This is later mortified by the Linker, 
after program relocation and linking is complete ^ to become 

RXT+A.) 



5.5.1 Aritfjnetic and Logical Operators 

An operator is a syFtfool which indicates an action (or ot.j«ration) to be 
performed. Two arithmetic and two logical operators are used by the 
CAPS-ll Asserfiler. The arithmetic operators are: 

■»• indicates addition or a positive number 

- indicates subtraction or a negative number 

The logical operators are: 

& indicates? the logical AND operation 

I indicates the logical inclusive OR operation 



The logical operators cause bit by bit comparisons {beti^reen two 16~tait 
words) to be performed with the following results t 



AND 



OR 






& 





= 













_ 








Sl 


1 


= 










1 


= 


1 


1 


& 





= 







1 


. 


^ 


1 


1 


& 


1 


= 


1 




1 


! I 


S££ 


I 



5.5,2 NuKtbers 

A number is any sequence of digits delimited by the tsritdnation 

characters discussed in Section 5,2, The Assembler accepts niaibera 
indicated in both octal and decinal bases. Octal nmnbers consist of 
the digits through 7 only? decimal numbers consist of the digits 
through 9 followed by a decimal point. (if a number contains an 8 or 
9 and is not followed by a decinal point, an error code will be 
printed and the nurvber will be interpreted by the Ass«rtoler as 
decimal»J A number which is preceded by a minus sign is interpreted as 
a negative number (thus it is not necessary to express a negative 
numli>er in ita two's conplenent f om) ; positive numbers may be preceded 
by a plus sign although this is not required. 

If a number is too large to fit into 16 bits, the number is truncated 
fron the left and an error code is printed in the assembly listing, 
NuirJiers and generated data are always considered as absolute 

quantities . 
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5.5.3 ASCII Conversion 

Vihen preceded bv an apostrophe, any AfiCII character (except null, 
r%il>out, carriage return, line feed, or form feed) is assigned its 
7-bit ASCII value (see Appendix A for a chart containing ASCII codes) . 
For example: 

•A 

assigns the ASCII character A the value OOOlOl(octal) , 

VihBn two ASCII characters are preceded by a quotation mark, (again the 
characters must not be null, rubout, carriage return, line feed, or 
fom feed) they are both assigned their corresponding 7-bit ASCII 
values; each 7-bit value is stored in an 8~bit byte and the bytes are 

coFibined to form a word. For example, "AB will store the ASCII value 
of A in the low-order (even) byte and the value of B in the high-order 
(odd) byte, as follows: 

High-Order Byte Low- Order Byte 

B'a value= ID 2 



100 


001 


s^ 


<^ 


4 


1 



• 








' i 





1 


=A's value 


'/ — 

)1 


000 



001 

I 




AB=041101 









ASCII text is always considered absolute by the Assembler. 



5*5,4 Assembly Location Counter 

As assetnbly proceeds, consecutive memory locations are assigned to 

each byte of object data generated. Thus, each word of object data is 
normally assigned even consecutive locations. 

The special character period (.) in the synbol for the assembly 
location counter; when used in the operand field following an 
instruction, a period represents the address of the first word of the 
instruction. 



NOTE 

The assembly location counter is not the 
same as the Program Counter as described 
in Section 5,7, 

For example, assuine the following statement occurs at location 502i 
At MOV #.>R0 
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The period refers to location 502, that is, the address of the MOV 
instruction. When used in the operand field following an assembler 
directive (see Section 5.8), the period represents the address of the 
current byte or word. Assume the following statement occurs at 
location 450! 

.BYTE 7 3, .>ADR 

In this case, the period refers to location 451, 

The Assembler clears the location counter at the heginning of each 
aasemhiy pass. Infomation is then normally stored in consecutive 
memory locations beginninr; at location for relocatahle sections, and 
V7herever the progranner indicates for absolute sections. The user may 
at any time change the location where the object data is to be stored 
hy a direct assignment statepient of the form 



=RXPRBS£;iC»l 



The expression defining the location counter must not contain 
references or symbols that vary from one pass to another. 



I orwara 



In the following example the programner usses .ABECT and .CSECT 
directives, which designate that code will be assigned either absolute 

or relocatable locations. These directives are explained in detail in 



,ASECT 



500 



J SET LOCATION COUNTER TO ABSOLUTE 500 



FIRSTS MOV . + 10, COUNT 



. = S20 



SECOND! >tOV .,I?JDEX 



VALUE 500<8> 

CONTE!StTS OF 

DEPOSI TED IN 



iTHE LABEL FIRST HAS THE 

I. + 10 EQUALS 510(S># THE 

^LOCATION 510<8) WILL BE 

I LOCATION COUfSIT. 

I THE ASSEMBLY LOCATI CW COLNTER N0« 

J HAS A V/^UE OF ABSEXUTE 5Sa£35. 

I THE LABEL SECCND HAS THE ym.UE 5S0C8>. 

J THE CONTENTS OF LOCATION 520£S), THAT 

*tS, THE BINARY CODE FOR THE IMSTRUCTItN 

* ITSELF, WILL BE DEPOSITED IN LOCATION 

Jl.'>*DEX 



. CSECT 

.a. +20 

THIRDS .WORD 



J SET LOCATION CQUMTER TO RELOCATABLE 20* 

J THE LABEl, THIRD HAS THE VALUE OF 
J RELOCATABLE 20 C DETERMINED BY THE 
* LINKER). 



Storage area may }>e reserved by advancing the location counter. For 
example, if the current value of the location counter is 1000, the 
direct assignment statement: 

•■.* 100 

will reserve 100(8) bytes of storage space in the program. The next 
instruction will be stored at 1100. 
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Sinilar to other symbols, the asser^bly location counter has a mode 
associated with it. The raotie is detsmined by the mode of the section 
In which it appears talisolute or relocatable). This mode cannot be 
changed by using a dfifining expression of a different mode. However, 
it may be changed by chancfing the mc^e of the section usinq either the 
»ASECT or .CSFCT directives as explained in Section 5,8,3, The mode 
cannot at any time be ejtternal. 



5.5.5 Modes of Expressions 

As already nentlcned, expressions consist of a term or the coiribination 
of terngs (terns being any symbol, number, ARCH data^ or the value of 
the current location counter) , Just as each tern of the expression 
can be assigned a mode (absolute, relocatable, or eKternal) , the node 
of the expression itself raay be determined as follows: 

An absolute expression is defined as: 

1. An absolute term preceded optionally by a single arithmetic 
operator, or 

2. A relocatable expression minus a relocatable term, or 

3. An absolute expj^ssion followed by an operator followed by an 
absolute expression, 

A relocatable expression is defined ass 

1. A relocatable term, or 

2. A relocatable expression followed by an arithmetic operator 
follcwed by an absolute expression, or 

3. An absolute expression folloved by a plus operator followed 
by a relocatable expression. 

An external expression is defined as: 

1, An extertial term, or 

2, An e^cternal esqsression followed by an arithmetic operator 
followed by an absolute term, or 

3, An al>solute expression followed by a plus operator followed 

by an external expression. 

In the following examples ABR represents an absolute term, REL 
represents a relocatable term, and Exr represents an external term. 
Thus , these are valid expresaions t 



.-^ 



EXT+ABS 
HEL+REL-REL 

ABS+RBL-RELSABS 



,• EXTERNAL EXPRESSION 
.•ABSOLUTE EXPra:RSION 
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The follcfwing are illegal expressions (and cannot be handled 
by the Linker) : 

EXT+REL 
REL+REL 

ABS-EXT 



properly 



5.6 RKLOCATinN AND LINKING 

The output of the Assemhler is a relocatable object module which must 
be processed by the Linker before it Ccin be loaded and executed. The 
object module contains the arsserobled binary output of absolute, 
relocatable, and external expressions. Sines absolute expressions are 
fixed in raenory, the Linker does no manipulation. However, the values 
of external or relocatable expresssions munt be fixed {or made 
absolute) by the Linker before it can create the load module which 
will contain Uie binary data to actually be loaded and executed. 

To enable the Linker to fix the value of an expression^ the Assembler 
must pass certain information concerning the expression on to the 
Linker. For example, each relocatable section of code in the source 
program has been assenbled sequentially with the first section 
beginning at location (called relocatable 0) f thus each relocatable 
expression is a relative number of locations from 0. (This 
value— relocatable n— and other information is passed to the Linker by 
means of the Global Symbol Directory and the Relocation Directory, as 
described in Section 5.14.) When the Linker relocates the section of 
code, it adds the relocatable value of the expression as provided by 
the Assembler to the base (or beginning location of the section after 
relocation) thereby producing an abBolute value for the expression. 

In the case of an external expression, the value of the external 
synljol in the expression is determined by the Linker (since the 
external symbol must be defined in one of the other object modules 
being linked) and this value is then added to the value of the 
external expression provided by the Asseraijler (see Section 5.5, 13), 

All instructions that are to be modified by the Linker in this manner 
',*ill be narked by a single apostrophe in the asseinlily listing, as 
illustrated in the foilovdng examples: 



005065 
000000' 



CLR EXTERNAL< 5> 



iVALye OF EXTERNAL SYmBCM. 

J IS ASSUMED TO BE ZERO, WILL 

I BE HODIFIED Bf THE LimER 



005065 
000006' 



CLR EXTERNAL*-6<5> 



* VALUE OF EXTERNAL SYMBOL 
J (ASSUMED ZERO) + 6 WILL BE 
J MODIFIED BIT THE LINKER 



00506S 
000040' 



CLR REL0CATABLE<5> 



J ASSUME CODE IS t^ m 

J ABSOLUTE SECTION A^IO 

J VALUE OF RELOCATABLE SYMBOL 

lis RH-CMIATABLE 40 
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5.7 ADDRESSING MODRS 

The eight general registers may be used for storing and manipulating 
data. Accessing these registers is done by means of register 
addressing modes. In order to understand htm the addressing modes 
operate and how they are assenbled, the action of the Program Counter 
must be understood . The Progran Counter (register 7 of the eight 
general registers) always contains the address of the next word to be 
fetched? i.e., either the address of the next instruction to be 
executed, or the address of the second or third word of the current 
instruction. The key nile is; 

Whenever the processor implicitly uses 
the Program Counter <PC) to fetch a word 
from memory, the Program Counter is 
automatically incremented by tvo after 
the fetch . 

That is, when aun instruction is fetched, the PC is incremented by two 
so that it is pointing to the next word in rner.ory. 

The following conventions are used in explaining the addressing modes j 

1. E represents any expression as defined in Section 5.5. 

2. R represents a register expression. This is any expression 
containing a tenn preceded by a 1 character or a symbol 
previously equated to such a term, as explained in Section 
5.4.4. 

3. ER represents: a) a register expression as explained in 2 
above, or b) an expression in the range to 7 inclusive. 

4. A represents a general address specification which produces a 
6~bit mode address field <source or destination address) as 
described in the PDP-11 PnoCESSOR HANDBOOK under the sections 
entitled single o^)erand Addressing and Double operand 
Addressing. 

Addressing modes for general registers Q-6 will be described first and 
then addressing using the Progran Counter (register 7) . The format 
for the addressing specification. A, is explained in terns of E, R, 
and ER as defined above. Rach will be illustrated with the single 
operand instruction CLR or douJ^le operand instruction MOV. (The user 
may also refer to the PDP-11 PTWCESROR HANDBOOK for information 
concerning addressing modes. > 



5.7.1 Pegister Mode (Mode 0) 

The register contains the operand, 

Fomat: R 

Example : 

R0=X0 I DEFINE R§ AS REGISTER 

CLR R0 jO-EAR register 
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5.7,2 Deferred Register Mode (Mode 1) 

The register contains the address of the oparand. 

Pornat! iJR or (er) 

Example ; 

CX,R »Rl 



or 



CLR CI) 



i CLEAR THE WORO At THE 
J ADDRESS CONTAINED IN 
J REGISTER 1 



5.7.3 Aiito increment Mode {Mode 2) 

The contents of the register are increnented imnediately after being 
used as the address of the operand. 

PomatE (ER) + 



Examples s 



CLR CR0>* J CLEAR WORDS AT ADDRESSES 

CLR CR0+3>* jCONTAENED IN REGt STERS 0*3* 

CLR t&i* imO Zf MD INCREMENT THE 

J CONTENTS OF EACH OF THESE 
i REG! STERS BY TWO. 



NOTR 

Both JIT and JSR instructions? using mofle 
2 increnent the register before its use 
on the PDP- 11/20 and 11/40 {but not on 
the PDP-11/05, 11/10, or 11/45). 

In do«I>le operand instructions of the 
addressing forn lR,(R)-i- Cor %n,-CR)) 
where the source and destination 
registers are the same, the source 
operand is evaluated as the 

autoincrenented (or autodec relented) 
value, but the destination register, at 
the time it is used, still contains the 
originally intended effective address. 
In tlie follo'-'ing tvro exariples, as 
executed on the PDP-11/23 and 11/40, RO 
originally contains 100. 



MOV R0, C0) + 



J THE QUANTITY 102 IS 
i MOVED TO LOCATION 100 



MOV R0,-f0) 



J THE OUANTITf 76 IS 
1 PROVED TO LOCATION 7 6 



The PDP-11/05, 11/10, and 11/45 handle 
tliQse instructions as follows t 
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MOV R0,<0)+ J THE QUi^TlTf 1 00 1 3 

JMOVED TO LOCATION 100 

MOV R0,-{0J iTHE QU^Tiry 100 IS 

1 MOVED TO LOCATION 7 6 

The use of these fomB should be avoided 
afl they are not cor'patihle among PDP-U 

processors. 



3,?, 4 Deferred Auto increment ^lode <mode 3) 

•Hie register is used as a pointer to the address of the of^rand. The 
contents of the register ar& increinented after being used, 

Fomatj @(ER) + 

Example t 

CLR tC3>* > CONTENTS OF REGISTER 3 POIhIT 

I TO ADDRESS OF WORD TO BE 
I CLEARED. COMTEMTS OF REGISTER 
1 3 ARE THEM INCREME?<TEO BY 2 



5.7,5 AutodecreTnent node (Mode 4) 

The contents of the regiister are decremented before being used as the 
address of the operand (see note in Section 5,7,3). 

Format: -(ER) 

Examples s 

CLR -{R01 J DECREMENT CONTEMTS OF REGISTERS 

CLR -(R0*31 10, 3 AND g BEFCPE ySINQ CONTENTS 

CLR -{2) J AS ADDRESSES OF WORDS TO BE CLEARED 



5.7.6 Deferred Autodecrenent Mode {ftode 5) 

The contents of the register are decreriented before being used as a 
pointer to the address of the operand, 

Pomat: §- (ER) 

Bxarr^ple : 

CLR »-caj 1 DECREMENT CONTENTS or RE6I STER S 

J BEFORE USING CONTENTS AS POINTER TO 
J ADDRESS OF WC^D TO BE CLEARED 
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5.7.7 Index Mode Cllode 6} 

The contents of the register (BR) and the value of the expression B 
are summed to form the address of the operand. The value of the 
expression E Is stored as the second or third word of the instruction 
and is called the bas«. The processor uses the Program Counter to 

fetch the base from rsemory; the PC is then incremented by two and 
points to the next word. 

Fomat: E{ER) 

EKainples t 

CLR X+2<R1J * EFFECTIVE ADDRESS IS X>£ PLUS 
iTrtE CONTENTS OF REGISTER 1 



CLR -2C33 



I EFFECTIVE ADDRESS IS -2 PLUS 

I THE CONTENITS OF REGISTER 3 



5.7.8 t)ef erred Index Mode O-tode 7) 

The value produced vrfieit the expression and tlie contents of 
register are added is a pointer to the address of the operand, 

Fomat! §E(ER) 

Example: 



the 



CLR fl4f4) 11 F REGISTER A CONTAINS Ig0, AND 

ILOCATICN 114 C0NTA3MS 2B00* LOC. 
l200e IS a. EARED 



ADDRBSBING USING RRGISTHR 7 (PC) 

Altliough Register 7 serves as the Program Counter, it aay also be used 
as a general purpose register. The PC responds to all the standard 
PDP-11 addrasflinq modes; however four of these modes are especially 
useful when writing Position independent Code (explained in Section 
5,9) ; these are suttnari^ed below. 



5.7.9 Iitmediate Mode (mode 2} 

Immediate mode allows the operand itself to be stored as the second or 
third word of the instruction* It is assembled as an autoincrement of 

register 7. 



PoEPiat : #E 
Examples t 

HQV #100,R3 



IHOVE «^ OCTj!^ 100 TO REGISTER 3 
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MOV iX#R0 I MOVE THE VALUE OF SfMBCa. X TO 
I REGI STEH 

An esqilanation of this mode folloi'^s. Using the first example above, 
the statement MOV #100, R3 assembles as two words? these ares 

012703 

000100 

Just before this instruction is fetched and executed, the PC points to 
the first word of the instruction (012703) . The processor fetches 
this word and increineiits the PC by two. Since the source operand mode 
is 27 (autoincrepient the PC) , the PC is used as a pointer to fetch the 
operand (the second word of the MOV instruction, OOOIOO). The PC is 
then incremented by two to point to the next instruction. 



5.7,10 Absolute Mode (Mode 3) 

In absolute (or deferred immediate) mode, the expression specifies an 
absolute address; the second worfl of the instruction contains the 
address of the operand. Absolute nrado is assei^bled as a deferred 
autoincrement of register 7, 

Format: @#E 

Examples s 

HOV »*240,R3 J MOVE CWTB^TS OF LOCATIO!^ 

J 240 TO REGISTER 3 

CLR i«C J CLEAR THE CCNTENTS OF HE 

iLOGATlOM WHOSE ADDRESS IS K 



5.7.11 Relative Mode (Mode 6) 

Relative node is asserjbled as index mode using register 7 and is the 
normal mode for memory references. 

Format : B 

Examples i 

CLR Ifejg jr CLEAR LOCATION 100 

MOV n»y I MOVE contents or locatio.^ 

IX TO locaticw y 

The base of the address calculation, which is stored in the second or 
third word of th# instruction, is not the address of the operand. 
Rather, it is the number v;hich, when added to the PC, becomes the 
address of the operand. Thus, the base is tltis address - PC, and is 
called an offset. The operation is explained as follov-rsi 
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If the statenent MOV 100, R3 if? assembled at absolute location 20, then 
the assemliled code is: 

Location 20 016703 
Location 22 000054 

The processor fetches the MOV instruction and adds two to the PC so 
that it points to location 22. The source operand mode is 67 (indexed 
by the PC) . To pick up the base, the processor fetches the word 
pointed to by the PC (location 22); the PC is then incremented by two 
and points to location 24, To calculate the address of the source 
operand, the base is added to the updated PC. Thus, 
base+PC=5 4+24=100 , the operand address. 

Since the Assenbler considers the assemJily location counter (.) as the 
address of the first word of the instruction, an equivalent index mode 
statement would be: 

MOV l00-.-4(PC)*R3 

This mode is called relative because the the operand address is 
calculated relative to the current PC. The base is the distance or 
offset (in bytes) between the operand and the current PC. If the 
operator and its operand are moved in memory so that the distance 
between the operator and data remains constant, the instruction will 
operate correctly anyvrhere in memory. 



5.7.12 Deferred Relative Mode (Mode 7) 

Deferred relative mode is indicated when the expression is preceded by 
@; the expression's value is the pointer to the address of the 
operand. 

Format : @K 

Examples : 

CLR 9AI I ADD SECOND WORD OF INSTRUCTION 

ITO THE PC TO OBTAIN A POIiMTER TO 
I THE ADDRESS OF THE OPERAVO, 
I CLEAR OPERAMO 

MOV 9X,R0 I MOVE THE Ctt'^TENTS OF THE 

ILOCATIOX WHOSE ADDRESS IS IN X 
UNTO REGISTER 



5.7.13 Tal)le of Mode Forms and Codes 

Table 5-2 sumarlzes the addressing modes. Each instruction assembles 

as at least one word. Operands of the first six forms listed below do 

not increase the length of an instruction. Each operand in one of the 

other modes, however, increases the instruction length by one word (n 
represents the register) . 
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Table 5-2 
Mode Porms ajid Codes 



Form ! 


Mode 


Meaning 


(Instruction length is not increased) 


R 




On 


Register 


?R or CER) 




In 


Register deferred 


(ER) + 




2n 


Autoincrement 


8{ER) + 




3n 


Autoincrement deferred 


-(ER) 




4n 


Autode crenent 


@-{EH) 




5n 


Autodecrement deferred 


(Instruction 


lengtl- 


1 increased by one word) 


E (ER) 




6n 


Index 


@E(ER) 




7n 


Index deferred 


m 




27 


Imirodiate 


i#B 




37 


Absolute n»FK>ry reference 


E 




67 


Relative 


fE 




77 


telative deferred reference 



NOTE 

An alternate fom for §R Is (ER) , 
However, the form §(ER) is equivalent to 
§0(RR) . 

The form ^#E differs from the form E in 
that the second or third word of the 
instruction contains the absolute 
address of the operand rather than the 
relative distance between the operand 
and the PC. Thus, the instruction 
CLR @#100 will clear absolute location 
100 even if the instruction is moved 
from the point at which it was 
asseiwhled* 



Ihe Assemt>ler is not particular about left and right and dangling -i- 
and - signs in address fields. The following are soroe examples of 
incorrect user syntax that will assenil:>ls as shown without any error 
indication, (X and Y are 16-blt address offsets) : 



Form 



Asseinbles As t 



{R2)X 


X(R2) 


X-{R2) 


X(R2) or X"-0( 


X{R2)+ 


XCR2) 


+ (R2) 


<R2) + 


(R2)- 


-(R2j 


§(R2)X 


@XCR2) 


X(R2)+y 


X+Y(R2) 
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5.7,14 Instruction Forms 

Instruction mnemonics are detailed in the PDP-11 PROCESSOR HMJDBOOK 
and suFtmarized in Appendix B, This section defines the number and 
nature of the operand fields for tiiese instructions. In the table 
that follows, let R, E, and KR represent expressions as defined in 

Sections 5,5 and 5.7? let OPR represent the operator; let A be a 6-bit 
address specification in one of these forms: 



R 


m 


"(ER) 


&~tT.n) 


R 


m or (R) 


ECKR) 


@ESER) 


(ER) + 


g (im) + 


#E 


§#F. 



A dJrJ JL Tab iu* ^ 

Instruction Operand Fields 



instriiction 


Form 


Example 


Douiile Operand 


OPR A, A 


MOV {R6>+,@Y 


Single Operand 


OPR A 


CLR -(R2S 


Operate 


OPR 


HALT 


Branch 


OPR E 


BR X+2 




where -12B< {i;-.-2)/2<=127 


BLO .--4 


Subroutine Call 


JSR ER^A 


JSR PCfSUBR 


Subroutine fteturn 


RTS ER 


RTH PC 


EMT/TRAP 


OPR or OPR E 


EMS 




where Q<=>B<= 377 (octal) 


EMT 31 



Branch instructions are one word instructions. The high byte contains 
the op code and the lovr byte contains an B"bit signed offset (7 bits 
plus sign) \-;hich specifies tlie branch address relative to the PC. The 
hardware calculates the branch address as follows: 

1, The sign of the offset is extended throucih bits 8-15, 

2, The result is multipl5.ed by 2j this creates a word offset 

rather than a byte offset, 

3, The result is added to the PC to forF. the final branch 
address. 

The Asseml>ler perfoims the reverse operation to fojon the byte offset 
from the si>ecifi«d address, tsihen the offset is a<Med to the PC, the 
PC is pointing to the word follov^ing the branch instruction, hence the 
factor -2 in the calculation. 

Byte offset = (K-PC)/2 truncated to eight bits. 

Since PC=.+2, the 

Byte offset = (E-.~2)/2 truncated to eight bits. 






nOTE 

It is illegal to branch to a location 

sfiecified as an external syF!l>ol, or to a 
relocatable symliol when within an 
ai>solute section, or to an absolute 
symbol when within a relocatable 

section. 

The Bf-ff and TRAP instrtictions do not use the low-order byte of the 
word. Thie allov/s information to be transferred to the trap handlers 
in tlie low-order byte. If Ein? or TRAP ia follov;ed by an expression, 
the value is put into the low-order byte of the VDrd, However, if the 
expression is too big (>377 (octal) ) it is truncated to eight bits and 
an QYTOT code is printed. 

The prograratier should not try to raicro-program the condition code 
operators (see Appendix B) as the CAPS-11 Assembler does not support 
this capability. Thus s 

acicLv 

results in an error message and the statement is asBer*>led as CLC, 

However, expressions allow logical operators and the use of 
instruction mnemonics. Thus, the following words are correctly 

.WORD CLC! JOPERAMD OF .WORD DIRECTIVE 

(see .Section 5.8.7) 
♦ CLCiCLV ) OPERAND OF DEFAULT .WORD 

fCLCICLV ) OPERAND OF DEFAULT .WORD 



5.3 ASSETOLER DlREOTIimS 

Assembler directives (sometimes called pseudo-ops) direct the assembly 
process and may generate data. Directives may be preceded by a label 
and may be followed by a coi^iTi«=nt, The assembler directive occupies 
the operator field and only one directive may be placed in any one 
staterient. A directive and its operand should be separated by a space 
or other legal terminator. Operands which are used with directives 
vary and are discussed individually. 



5.6,1 .TITLE 

The .TITLE directive is used to name the object module. The naiws is 
assigned by the first syi!d>ol following the directive. If there is no 
.TITLE statement the default name assigned is ".KAIN.*, "Knusj 

.TITLE 

FILElS MOV *NAME>R0 

assigns the name FILEl to the current object module. 
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5.8.2 .GLOBL 

The .GLOBL directive is used to declare a symbol as being global. A 
global synbol is generally referenced by more than one object mocltile. 
It may be an entry symbol, in which case it is defined in the current 
program, or it may be an external syndiol, in which casa it is defined 
in another pro^irara which will be linked with the current program by 
the Linker. The fom of the .GLOBL directive iss 

. GLOBL NRMA , NAfIB , . . . ,NAMN 

where syribola MAMA,KAMB,, . .KAKN are all defined as global symbols, 

NOTE 

A symbol cannot be declared global by 
defining it as a global expression in a 
direct af?signFient statement. 

If an illegal character is detected in the operand field of a .GIXJBL 
statement an error raessage is not generated but the Asaembler may 
ignore the remainder of the statement. Thus: 

.GLOBL A*B, iC#D 

assembles without error as; 

.eLOBL A*B 



5.8.3 Program Section Directives {.ASBCT and .CSBCO") 

The relocatable Assembler provides two directives enabling the 
procrainraer to specify that parts of his prorfram be asBembled in 
absolute sections and other parts in relocatable sections. The scope 
of each directive extends until a directive to the contrary is given. 
The Assembler initially starts in a relocatable section; to enter an 
absolute section, the .ASECT directive is indicated. Thus, if the 
first statement of a program is: 

Al .ASECT 

the label "A" would be a relocatable symbol which is assigned the 

value of relocatable zero. The Linker will later calculate the 
absolute value of A by adding the value of the base of the relocatable 

section. For example: 

.ASECT iASSE?4BLER IN ABSOLUTE SECTlOf* 

.»10e0 tPC=\&0& ABSOLUTE 

At CLR X i A- 1060 ABSOLUTE 

.CSECT jASSEfiBLE IH REa.OCATAIILE SECTION 

Ki JHP A t<=0 RELOCATABLE 

.EMD 

tihe prograrmer may alternate between relocatable and absolute sections 
aa follows I 
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. CSECT 

.WORD 0,t#a »ASSErtBLED ikJ RELOCATABLE 0, g, MD 4 

•ASECT 

.MOiRO 0j.l#2, i ASSEMBLED AT ABSOLUTE 0, Z* AiNSD 4 

. CSECT 

.WORD J ASSEMBLED AT RELOCATABLE 6 

.END 

If a label is defined twice, first in an absolute section and then in 
a relocatable section, the symbol will be relocatable but its value 
will be as defined in the absolute section. 

Chapter 6 provides details concerning how the Linker handles absolute 
and relocatable program sections at link-time* 



5.8,4 ,£01* 

NOTK 

The CAPS -11 Assembler provides the .EOT" 

directive for the user who may wish to 
write a program for execution under 
another systen allowing the use of paper 
tape. For that reason, it is described 
here, although the average CM*f>-ll user 
will have no need to reference it and 
the CAPfi~ll Asseinbler will ignore it. 
The following discussion of the .EOT 
directive details its use as it pertains 
to the Paper tape Software System. 

The .EOT directive indicates the physical End Of Tape though not the 
logical end of the program. If the .EOT is followed by a single line 
feed or form feed, the Assenbler will still read to the end of the 
tape, but will not process anything past the ,Emf directive. If .EOT 
is followed by at least two line feeds or form feeds, the Assembler 
will stop before the end of the tape, Bitlier case is proper; even 
though it may appear as though the Assembler has read too far, it 
actually has not. 

If .EOT is eniedded in a tape, and more information to be assembled 
follows it, ,BOT must be immediately followed by at least two line 
feeds or forw feeds, Otheruise, the first line following the .EOT 
will be lost. 

Any operands following a .EOT directive will be ignored. The .EOT 
directive allows several physically separate tapes to be assembled as 
one progriim. The last tape should be terminated by a .END directive 
(see section 5,8,6) but may be terminated with .EOT. 



5.8.5 .BVEM 

The .EVEM directive ensures that the ass^ttbly location counter is even 
by adding one if it ia odd. Any oi^rands following a .EVEN directive 
will be ignored. 
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5.8.6 . KND 

The .END directive indicates the logical and physical end of the 
source progran. The .END directive nay be followed by only one 
operand — an expression indicating the program's transfer address. At 
load tine, the load module will be loaded and program execution will 
begin at the transfer address indicated by the .END directive. If the 
address is not specified and a RUN or LOAD/G comnand is used, a fatal 
error message will be printed; if a LOAD/0 cormand is used, CABLDR 
will halt and expect user console action (see Appendix E) ; a LOAD 
Gomnand in conjuction with the START cormand allowB the user to 
indicate an optional starting address for the program. 

If there is no .END directive in the user's progran, the Assembler 
will issue the message: 

?M0 END STMT 

at the end of the last input file and will continue as if there had 
been an .END statement there. 



5,8.7 .WORD 

The .WORD assenhler directive may be follo^^ed by a space and one or 
more operands separated by coninas and instructs the Assemil>ler to store 
each op*; rand in successive words of the object program. the operands 
may be any legally formed expression. For example; 

. a 1 420 
5AL«0 

.WORD IT7S3S, .♦4#SAL I STORED IM S^OROS 14S0* 1422 

J AND 1424 HILL BE 1??535* 

Values exceeding 16 hits will be truncated from the left to viord 
length. 

A .WORD directive followed by one or more voirl oi^erands separated by 
conmaR will store ^seros for these operands. For exaicple: 

,= 1430 i£ERO# FIVE* AND 2ER0 ARE STORCO 

.WORD »5. tm WORDS M30, 1432* ^0 M34 

If a Btatenent contains no operator, this field will be interpreted as 
a .WORD directive providing the operand field contains one or more 
expressions. The first tern of the first expression in the operand 
field imist not be an instruction nuienonic or asseptfiler directive 
unless preceded by a -f or -. or one of the logical operators, 1 or £. 
For exar>plej 

,=440 jthe op-code for MOV (0i0e«0> 

LABELS +MOV, LABEL J IS STOKED IN LQCATIQH 4<e. 

fA40 IS STORED If* LOCATION AA2. 
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Note that the default .WORD directive will occur whenever there is a 
leading arithmetic or logical operator, or vfhenever a leading syitibol 
is encountered in the operator or operand field which is not 
recognized as an instruction mnenonic or asseinbler directive. 
Therefore, if an instruction mnejnonic or assepjiler directive is 
misspelled, the .WORD directive is as.suFied and errors will result. 
Assume that MOV is spelled incorrectly as IIOR: 

MOR A, B 

This will result in two errors caused tays a J an expression operator 
missing between MOR and h, and b) MOR being undefined, Tvfo words will 
be generated; one for MOR A and one for B, 



5.8.8 



.BYTE 



The .BYTE directive nay be followed by a space and one or nore 
operands separated hv comas and instructs the ^sserfiler to store each 
operand in a byte of* the object program. If multiple operands are 
specified, they are stored in successive bytes. The operands may be 
any legally formed expression witli a result of 8 bits or less. For 
example : 

SAHaS I STORED IN LOCATION! 410 WILL BE 

. = 410 J 060 (THE OCT^ EQUIV(1.ENIT OF 48). 

.BYTE 4g.,SAM ilH All WILL BE 003 

Since the expression is evaluated as a word expression, if it is found 
to have a result of more tJian 3 bits, it will be truncated to its 
low-order 8 bits and an error will be flagged. If an operand after 
the .BYTE directive is left void, it will be interpreted as zero. For 
example s 



,s420 
■BfTE , 



J ZERO WILL B£ STORED IN 

J BYTES 420* 431 mO 4£g, 



If the expression is relocatable, a warning will be printed. 



5.8.9 .ASCII 

The .hBCll directive translates strings of ASCII characters (with the 
exception of null, rubout, carriage return, line feed, and fom feed] 
into their 7-bit ARCH codes. The text to be translated must be 
enclosed by a delimiting character which may be any printing ASCII 
character except colon and equal sign and those characters used in the 
text string itself. The 7-bit ASCII code generated for each character 
will be stored in successive bytes of the object program. Tor 
example! 

.»S00 J THE ASCII CODE FORY t WILL BE 

• ASCII /YES/ ISTWED IM 50B. THE CODE FOK E 
ll.^ 501, THE CODE FOR S IN S0B, 
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.ASCI] /5+3/ai/ 



J THE DELIMITING CHARACTER OCCURS 
J BETWEEN THE OfERmBS, TrtUS THE ASCII 
J CODES FOR 5* *, mO 3 ARE STORED 
flH BYTES 503, 504, AND 5B5, 2/ IS 
J NOT ASSEMBLED. 



The .ASCII directive may be terminated bv any legal terminator (as 
listed in Section 5.2 #3) except = and j. Note that if the text 
delimiter is also a legal terminator, it nay serve a double function, 
terminating the directi-^e and delimiting the text. For example j 



.ASCII /ABCO/ 



;THE SPACE IS 
J BECAUSE / IS 
J TERMINATOR. 



REQUIRED 
NOT A LEGAL 



. ASCII +ABCD+ 



IMO SPACE I S REOUIBEO 

J SI MCE + IS A TER->ll,^ftTOR. 



5 . 8 . 10 . RAD50 

PDP-ll systeiR programs often handle syinbolg in a specially coded form 
called "RADIX 50" (sofmetimas also referred to as "MOD40") . This form 
allows 3 characters to be packed into 16 bits? therefore, any symbol 
can be held in two words. The fonfL of the directive is: 

.RAD 50 /CCC/ 

The single operand is entered in the form /CCC/ where the delimiter 
(in this case, slash) can be any printalile character except = and : 

and those characters ■used in the operand. Characters which may be 
converted are A through Z, through 9, dollar C$), dot (.) and space 
( ) . If there are fewer than 3 characters they are left-Justified and 
trailing spaces are assiipied. Any characters following the enclosing 
delimiter are ignored and no error results. For example i 



.RAD50 /ABC^ 
.RAO 50 /AB/ 
.RAD50 // 



fPACK ABC IHTQ mE WORD 

*PACK AB < SPACE? INTO QUE irfORD 

»PACK 3 SPACES INTO ONE WORD 



The packing algorithm is as follovis; 

1. Each character is first translated into its RADIX 
equivalent as follows: 



50 



Character 

A-Z 
$ 

# 

0-9 



RADIX SO Equivalent (octal) 



1"32 

33 

36-47 



Mote that another character can be defined for code 35, 
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2. The RADIX 50 equivalents for the three characters (Cl, C2 , 
C3) axe then cornbined as follows : 

RESULT=<CC1*5Q)+C2|*50+C3 

and the result is stored in the word. For example, the RADIX 
50 value Of ADC is 3223. 



The . LIMIT directive generates two words into which the Linker puts 
the low and high addresses of the relocated code. The lew address 
{stored in the first word) is the address of the first byte of 
relocated code? the hicjh address is the address of the first free byte 
following the relocated code. These addresses will always be even 
since all relocatable sections are loaded at even addresses; if a 
relocatable section consists of an odd number of bytes the Linker adds 
one to the size to make it even. 



5, a. 12 Listing Control Directives (.LIST and ,HLIKT]I 

The .LIST and .HLIST directives allow the user to choose which 
sections of his progran will appear in the asflembly listing. The 
.HLIST directive suppresses the assemlJly listing and the .LIST 
directive reinitiates it. Thus if the user is developing a program 
and has a large section of code which does not change from one edit to 
the next, he can insert a ,NLIf)T directive at the beginning of that 
code and a .LIST at the end. That code will not api^ar in the 
asseimbly listing. 

If the ,NLIST directive is in control when the sypibol table is ready 
to be output, the .NLIST directive will be terminated go that the 
symbol table can lie listed. 



5.8.13 Conditional Assemlily Directives 

Conditional assersihly directives provide the programmer with the 
capability of conditionally including or not including portions of his 
source code in the assembly process. In the explanation which 
follows, E denotes an expression. The conditional directives ares 



Directive 


Exp 


ression 


.IFZ 




E 


.IFNZ 




E 


.IFL 




E 


.IFLE 




E 


.IFG 




E 


.IFGE 




E 



Result 

Assffloble if E=Q 

Asseinble if E^O 

Assemble if E<0 

Assemble if E<"0 

Assemble if E>0 

AssemJile if E">0 



If the condition is met, all statements following the conditional 
directive are assembled until a special delimiting directive, .ENDC, 
is encountered. If the condition of the directive is not met, these 
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stateFients are ignored. when the ,ENDC directive is detected, 
assertily continues as usual^ 

Two more conditional directives are used; these take the following 
form; 

.IFDF Saj E!,S] B(2) Ii,5] ,... E!,S]SCK) 
,imm B(l) [l,S} S(2) C!,SJ,...[!,6]SCN) 

where S(l) though S(N) represent syiiools, I represents the lotjical OR 
operation, and s represents the logical AND operation. .IFOP and 
.IRJDF mean 'if defined" and "if undefined" respectively. The scan is 
from left to right, no parentheses permitted. Nesting is permitted up 
to a depth of 127{decinal), For exanple: 

,IFDF SHW Asse)«iile the following code (until 

detection of .ENDC) if either S or 
T is defined and U is defined 

.ir>*DF TSUiS Asaerohle the follovfing code (until 

detection of ,ENDC) if both T and U 
are undefined or if S is undefined 

General reinarks concerning conditional directives include the 
follovfing: 

1. A null expression or an expression in error use the default 
value for pwrposes of the conditional test. 

2. An error in syntax, e.g., a terminator other than ; I S or 

CR results in the undefined situation for . IPOF and .IFMDP, 
as does a null symbol or syitibol in error. 

3. All conditionals mupit end with the ,EKDC directive. Anything 
in the operand field of .ENDC is ignored. 

4. Laliels are permitted in statetnents containing conditional 
directives; however, since the scan is purely from left to 
right, in the follcsiing example: 

.IFZ I 

A: .CNIOC 

the label A \^ill be ignored (as the Assembler ignores all 
code between the conditional directive and the .ENDC 
directive) , while in this example} 

At ,IFZ I 
CLR K 
.ENDC 

A is entered in the syribol table. 

5. If an .END directive xb encotaitered while inside a satisfied 
conditional, an error will be flagged} however, the .END 
directive will still be prmsessed nornally. 
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6. If more than one .EiJDC directive is encoitntered (per 
conditional directive) , errors are flagged on those in 
excess. 



5.9 WRITING POSITION INDEPKNDKNT CODE (PIC) 

When a standard program is available for use by other programs, it is 
often beneficial to be able to load and execute the program in 
different areas of menory. There are several V7ays to do this: 

1. Reassenbie the progran at the desired location. 

2. Use a relocating loader which accepts specially coded binary 
object modules from the Assembler, 

3. Have the program relocate itself after it is loaded. 

4. Write code which is position independent. 

On snail machines, reassemlily is often performed; ho^«rever, the CAPS-11 
System has a relocating loader (Linker; see Chapter 6), and this is 
preferable. Since it generally is not economical to have a program 
relocate itself (as hundreds or tliousands of addresses may need 
adjustment) , writing position independent code is another metliod of 
producing a relocatable program. 

PIC is achieved on the PDP-11 by correct usage of those addressing 
modes which form an effective memory address relative to the Program 
Counter (PC), Thus, if an instruction and its object (s) are moved in 
such a way that tlie relative distance between them is not altered, the 
same offset relative to the PC can be used in all positions in memory, 
PIC usually references locations relative to the current location, 
although al>solute references may be made as long as the locations 
referenced remain stationary while the PIC is relocated. For example, 
references to interrupt and trap vectors are absolute, as are 
references to device registers in the "external page" (28K to 32K) , 
and direct references to the general registers. 



5.9.1 Position Independent Modes 

There are three position independent modes, or forms of instructions: 

1, Branches — the conditional branches, as well as the 
unconditional branch, BR, are position independent since the 
branch address is computed as an offset to the PC {see 
Section 5.7.11) . 

2. Relative Memory References — any relative memory reference of 

the form: 

CLR X 
MOV X^y 
JMP X 
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is position Independent because the Assembler assembles the 
reference as an. offset indexed by t!ie PC, The offset is the 
difference betv?een the referenced location and the PC. For 
example, assune the instruction CIiR 2D0 is at address LOOs 

100 005067 J FIRST WORD OF CLR ZHd 

102 00007 -Id J OFFSET = 200-10-* 

The offset is added to the updated PC, (The updated PC has 
been incremented by two and contains 104, i.e., the address 
of the word follwdng the offset} . 

Although the form CLR X is position independent, the form 
CLR @X is not. Consider the foUo^^ings 

Si CLR iX » CLEAR LOCATIO.^ A 

* 

Kt .WORD A J POINTER TO A 

* 

Ai .UORD 



The Contents of location X are used as the address of the 
operand in the location labeled A, Thus, if all of the code 
is relocated^ the contente of location X must be altered to 
reflect the new address of A. However, if A was the name 
associated with some fixed location Ce.g. , a trap vector or a 
device register} , then statements S and X would be relocated 
and A would remain fixed. The follov/ing code is position 
independent: 

Aa36 } ADDRESS OF SECCK4D WORD 
J OF TRAP VECTOR 
St CLR •>< J CLEAR LOCATi O^f A 



.WORD A JPOIMTER TO A 



Immediate Operands—The Asseml->lRr addressing form #E 
specifies immediate data, that is, the operand is part of the 
instruction {see Section 5.7.9). Thus, inmediate data is 
position independent and is moved with the instruction. 
Immediate data is fetched u,s?ing the PC in the autoincrement 
node. 

As with direct memorj' references, the addressing form @#E is 
not position independent since the final effective address is 
absolute and points to a fixed location not relative to the 
PC. 



5.9.2 Absolute Modes 

Any time a rtwmory location or register is used as a pointer to data, 
the reference is absolute. If the referenced data is fixed In metnory 






independent of the position of the PIC (e,g,, trap-interrupt vectors 
or device regis tern) , al^solute modes must be used, <Khen the 
programer is not writing position independent code^ references to 
fixed locations may be performed using either the absolnte or relative 
fom.) If the data referenced is relative to the PIC, absolute i<iodes 
must not be used unless the pointers in-volved are modified. The 
absolute modes are : 

§E Location K is a pointer 

§#E The immediate word is a 

pointer 
(R) The register is a pointer 

(R)+ and ™(R) The register is a pointer 
@(R)+ and §-CR) The register points to a 

pointer 
R(R) 1^=6 or 7 The base, E, modified by (R) 

is the address of the operand 
@E{R) The base, modified by (R) , is 

a pointer 

The non-deferred index modes and stack operations require a little 
clarification. As described in Sections 5,7.11 and 5.9.1, the form 
E(7) is the normal mode to reference memory and is a relative mode. 
Index mode, using a stack pointer (RP or other register) is also a 
relative mode and may ha used conveniently in PIC, Basically, the 
stack pointer points to a dynamic storage area and index mode is used 
to access data relative to the pointer. The stack pointer may be 
initially set up by a position independent program as shov^n in Section 
5.9.4. Once the pointer is set up, all data on the stack is 
referenced relative to the pointer. It should also be noted that 
since the form 0(RP) is considered a relative mode, so is its 
equivalent @SP. In addition, the forms (SP)+ and -(SP> are required 
for stack pops and pushes. 



5, §.3 Writing Automatic PIC 

Automatic PIC is code ^^ich requires no alteration of addresses- or 
pointers. "Ehus, memory references are limited to relative modes 
unless the location referenced is fixed (trap and interrupt vectors, 
etc.). In addition to requirenents already mentioned, the following 
must be observed j 

1, Start the prograim with .=0 to allow easy relocation using 
CABLDR (see Appendix E). 

2, All location setting statepents must be of the form .=.+x or 
.= function of tags within the PIC,* for example, ,=A+10 where 

3, There must not be any absolute location setting statements. 
This means that a block of PIC cannot set up trap and/or 
interrupt vectors at load time with statenents such as: 

.WORD TRAPH»340 J TRAP VECTOR 
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CABIjDH, when it is relocating PIC, relocates all data by the 
load bias (see Appendix E) . Thus, the data for this vector 
would be relocated to some other location . Vectors may be 
set at execution times <as discussed next) . 



5,9.4 Writing Non-Autc3Watic PIC 

Often it is not possible or economical to write totally autcmated PIC; 
in these cases, scne relocation may be easily perforned at execution 
time, Sco?ie of the methods of solution are presented below. 
Basically, the imethods operate by examining the PC to determine where 
the PIC is actually located; a relocation factor can then be easily 
ooFiputed. In all examples, it is assumec! that the code is assembled 
at zero and has been loaded somewhere else by CABLDH, 



Setting up the stack Pointer - Often the first task of a pjRsgram is to 
set the stack pointer |SP) . This may be done as follows t 

. = I BEG IS THE FIRST I MSTHUCTI ON 

I OF THE PftOQRAM. 
BESI MOV PCmSP I SP* address BEG+2 

TST -CSP> » DECREMENT SP BY 2. 

I A PUSH CNTO T^IE STACK WILL STORE 

»THE DATA AT BEG-B. 



Setting up a Trap or Interrupt Vector - Assume the first word of the 
vector will point to location INT which is in PIC, 

X! MOV PCJ.R0 J R@= ADDRESS K^S 
AOD 01NT-K-2,m I ADD OFFSET 
MOV R0j,i#VECT J HOVE POINTER TO VECTOR 

The offset irJT-X-2 is equivalent to INT-(X+2)f X+2 is the value of the 
PC moved by statement X. If PC(0) is the PC that was assumed for the 
proffram when loaded at and if PC(n) is the current real PC, then the 
calculation is: 

IHT-PC(0)+PCCn)=INT+(PC(n>-PC(0) } 

Thus, the relocation factor, PC(n5-PC{0)^ is added to the assembled 
value of INT to produce the relocated value of INT, 



Relocating Pointers ~ if pointers must be used, they may be relocated 
as shown alcove. For example^ assume a list of data is to be accessed 
with the instruction ; 

ADD (Re)*#Rl 

The pointer to the list, list L, may be calculated at execution time 
as follows! 
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MS HOV PC*R8 ^GET CURRErJT PC 

ADD *L-M-2, R0 JtAOD OFFSET 

/mother variation is to gather all pointers into a table. The 
relocation factor nay be calculated once ancf then applied to all 

pointers in the table tising a loops 

Kt i^OV PC^m I RELOCATE ALL ENTRIES IN PTRTBL 

SOB #X-t-e,R0 JCALCLft.ATE HEtOCATlSW FACTOR 

HQV #PTRTa.,Rl IGET AND RO-OCATE A POINTER 
ADO R0,R1 iTO PTRTBL 

HOV #TBLLEi'^j.R2 J GET LENGTH OF TABLE 
LOOP! ADD R0, fRD* Jt RELOCATE AN ENTRy 

DEC R2 ; COUNT 

BGE LOOP i BRANCH 1 F N OT DONE 

Care must he exercised vjhen restarting a progran wlii ch relocates a 
table of pointers. The restart procedure must not include the 
relocation, i.e., the tal>le must be relocated exactly once after each 

XO«.CI ^ 



5.10 LOADING UTIUSEO TKAP VKCTOKS 

Cme of the features of the PDP-11 is the ability to trap on various 
conditions such as illegal instructions, reserved instructions, power 
failure, etc. However, if the trap vectors are not loaded with 
meaningful information, the occurrence of any of thesa traps will 
cause mipredictal)le results. By loading the vectors as indicated 
below it is possible to avoid tliose i^rohlens as well as gain 
meaningful information aJiont any une3cp*?cted traps that occur. This 
technique, which makes it eftsy to identify the source of a trap, is to 
load each unused trap vector with; 

.=trap address 

.WORD .+2, HALT 

This will load tlte first word of the vector with the address of the 
second word of the vector (vihicli contains a HAJjT) , Thus, for example, 
a halt at location 6 means that a trap through ti^e vector at location 
4 lias occurred. The old PC and status may he exaninecl hy looking at 
the stack, pointed to by register 6. 

Trap vectors of interest are listed in Table 5-4. 
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Ta)>le S-4 

Trap Vectorf? 



Vector • 
Location i 


Halt At 
Location 


Iteaning 


4 


6 


Bus Error; illegal Instruction j 
stack OverflcK'? Nfiiwsxistent I-tenoryj 
nonexistent nevice; Word Keferenced 
at Odd Address (leaded by 
HRSriOH — causes Monitor TRAP error 


10 


12 


Reserved Instruction (Loaded by 
PXPfmi — causes Itonitor TRAP error 
message) 


14 


16 


Trace Trap Instruction (0000035 or 
T-hit Bet in Rtatur; Word (used tay 
ODT; loadnd with a IWLT by RESnON) 


ZQ 


22 


lOT Executfid [used by KRflTON) 


24 


26 


Power Failure or Restoration 
(loaded with a HAI.T by REPMON) 


3n 


32 


EMT Executed (loaded with a riAI^T by 

RTsrion) 


34 


36 


Trap Executod {Loadod with a HALT 
by REnilOM) 



5.11 CODING TECHMIOUnS 

Because of the great flexibility in PDP~11 coding, tiwe-savirsg and 
Bpace-saving ways of perforrLinn operations may not be immediately 
apparent. Some s^-iecial coding techniques are presented in this 
section. 



5,11.1 Altering Register Contents 

The techniques described in this section take advantage of the 
automatic stepping feature of autoincrement and autodecrenent nodes 
when used especially in THT and CMP instructions. Biese instriictions 
do Slot alter operands. 



These alternative way?? of altering 
register contents affect the condition 
codes differently. Register contents 
Fiust be even when stepping by 2 , 
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1. Adding 2 to a register might be accoin.plished by ADD #2,R0. 
However, this uses two words, whereas CMPB (RO)+,(RO)+ (which 
also adds 2 to a register) , uses only one word. 

2. Similarly, subtracting 2 fron a register can he done by the 
complementary instructions SUn #2,R0 or crtPB -CR0),-(RO). 

3. Two may be added or su])tracted from two different registers, 
or 4 from the sane register, in one single-word instruction 
as follows ; 

CMP <R0>«-f CR0)+ lADD A TO R0 

CMP -<R1>»-<R1> i SUBTRACT 4 FROM Rl 

CMP <R0>*-,-<Rl> lADD 2 TO R0* SUBTRACT S FROM Rl 

CMP -<R3>.-(Rn I SUBTRACT 2 FROM BOTH R3 Ai^^D Rl 

CMP <R3»*-.CR0)+ lADD 2 TO BOTH R3 AMD R0 



4. Variations of the examples above can be employed if the 
instructions operate on bytes and one of the registers is the 
Stack Pointer. These examples dajTend on the fact that the 
Stack Pointer (as well as the PC) is always autoincrenented 
or autodecremented by 2, wliereas registers R0-R5 step by 1 in 
byte instructions. 

CMPB (SP)+.<R3)+ lADD 2 TO SP AND I TO R3 

CMPB -<R3>*-{SP) I SUBTRACT 1 FROM R3 « 2 FROM SP 

CMPB {R3)+,-CSP) I ADD 1 TO R3* SUBTRACT 2 FROM SP 

5. Popping an unwanted word off the processor stack (adding 2 to 
register 6) and testing another value can be two separate 
instructions or one combined instruction: 

TST CSP>*- i POP WORD 

TST COUNT J SET CCNDlTlON CODES FOR COUNT 

or 

MOV COUNT, CSP>«- J POP WORD t SET CODES FOR COUNT 

The differences are that TST instructions use three words and 
clear the Carry hit, while the MOV instruction uses tv70 words 
and does not affect the Carry bit. 



5.11.2 Subroutines 

Condition codes set within a subroutine can be used to conditionally 
branch upon return to the calling progran, since the RTS instruction 
does not affect condition codes. 

JSR PC>X iCALL SUBROUTINE X 
BNE ABC tBRmCH ON CONDITION SET 

t IN SUBROUTINE X 

Xi i SUBROUTINE ENTRY 
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CMP R2,DEF J TEST CDNDITICN 

RTS PC iRETURf* TO CALLltiS PROGRAM 



l*ien the register in the first operand of a JSR instruGtion is not the 
PC, data stored following a subroutine call can be accessed within the 
subroutine by referencing the register, {The register contains the 
return address.) For example; 

JSR R5*Y 
>WORD HIGH 

.WORD LOW 

iLATEST RS VM,UE yiLL POINT HERE 



ft MOy tRS)*»n2 

MOV (R5>+*R4 



i VALUE CF HICM ACCESSED 
I VALUE OF LOtf ACCESSED 



RTS RS 



IRETUI^ TO LOCATION 
I CONTAINED m Ri 



Another possibility is« 



JSR R5, sue 
BR PSTARG 



.WORD A 
•WORD a 
.WORD C 



J LOW- ORDER WTE IS OFFSET TO 

J RETURN ADDRESS, HHI CH ESyALS 

J OF ARSS. 

I ADDRESS OF ARG A 

I ADDRESS OF ARS a 

I ADDRESS or ARG C 



NO- 



PSTARGI 



I RETURN ADORESS 



SUBi 



MOVB »R5* COUNT 



MOV 
MOV 



f 14(R5>#R2 
»6<R5)#R1 



iGET NO. OF ARGS FROH LOW BfTE 

I OF BR <1F DESIRED). 

I E.G.* GET 6TH ARGUMENT 

IGET THIRD ARGUMENT 



RTS R5 



J RETURNS TO BRANCH WHICH JUMPS PAST 
J ARG LIST TO REAL RETURN ADDRESS. 



In the exaniple above, the 
advantages : 



branch instruction contributes two main 



If R5 is unaltered when the KTB is executed^ return will 
always be to the branch instruction* This ensures a return 
to the proper location even if the lenc}th of the argument. 
list is shorter or longer than expected. 
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2, The operand of the branch, being an of fset past the argunent 
list, provides the nunber of arguments in the list. 

Arguments can be made sharable by separating the data from the raain 
code. This is easily accomplished by treating the JSR and its return 
as a subroutine itself: 

CAUi.J 



JSR PC*ARSl.ST 



ARSLST; JSR RS# SUB 

SR PSTARG 
.WORD A 



The examples above all demonstrate the calling of subroutines frcm a 
non-reentrant program. The called subroutine can be either reentrant 
or non-reentrant in each case. The follwfing example illustrates a 
method of allowing calling programs to be reentrant. The arguments 
and linkage are first placed on the stack, sim.ulating a JSR RS,SUB, so 
that arguments are accessed from the subroutine via X(R51. Return to 
the calling program Is executed from the stack. 

CALLt 



MOy R5#-CSP> 
MOV JSBRJ.-CSP) 



iSAVE R5 ON STACK 
jFUS^ INSTRUCT! (M JSR f?6, tRS ON 
J STACK. PUSH ADDRESSES OF 
JARSlWi^TS m STACK IN REVERSE 
J ORDER <SEE Ba-OO 



MOV 8RN*-<SP> 

X! MOV SP.R5 

JSR PC#SU8 
RETj MOV <SP> + #R5 



J PUSH BRft-^CH IPISTRUCTlQNf ON STAC»< 
JMOVE ADDRESS CT BRAN 04 TO RS 
iCmi. SUB AflO SAVE RETURN ON STAO< 
J RESTORE OLD RS UPON RETURN. 



i DATA AREA OF PROGRAM 



JSBRi 

BRNi 



JSR R6* iR5 
BR .♦N+NI+2 



J BRANCH PAST M WORD ARGUMENTS 



The address of an argument can be pushed on the stack in several ways. 
Three are shown below. 



1. 



The arguments A, B, and C are read-only constants which are 
in memory (not on the stack) i 



MOV #C>-tSP> 
MOV #B#-CSP> 
MOV #A,-(SP) 



I PUSH ADDRESS OF C 
I PUSH ADDRESS OF B 
J PUSH ADDRESS OF A 
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Arguments A, B, and C have their addresses on the stack at 
the Lth, Mth, and Hth bytes from the top of the stack. 



MOV NCSP>,-(SP) 
MOV M*-2<SP),-(SP1 
MOV L+4<SP),-CSP> 



J PUSH ADDRESS OF C 
iPUSH ADDRESS OF B 
J PUSH ADDRESS OF A 



Note that the displacements frori. the top of the stack are 
adjusted by tv.'o for each previous push because the top of the 
stack is being moved on each pusJi, 



Argi^nents A, B^ and C are on the stack at the Lth^ Mthj, 
Mth bytes from the top but their addresses are not. 



and 



MOV #N*2, ~CSP) 

ADD SP, «SP 

MOV #M+4,-CSP> 

ADD SP, «SP 

MOV #L+6#-(SP) 

ADD SP, «SP 



I PUSH DISPLACiMIMT TO ARGUMENT 
ICALCU-ATE ACTUAL ADDRESS OF C 

J ADDRESS OF B 

J ADDRESS OF A 



Vfiien subroutine SUB is entered, the stack appears as follows! 



RET 



BR .+tRH+2 



K 



JSR R6.@K5 



Old R5 



IBRMTCH IS TO HERE 



Subroutine SUB returns by means of an RTS RS^ which places R5 into the 
PC and pops the return address from the stack into R5. This causes 
the execution of the branch since R5 has hssn loaded at location X 
with the address of the branch. The JSn branched to then returns 
control to the calling progran, and in so doing, luoves the current PC 
value into the SP, thereby removing everything above the old RS froin 
the stack. Upon return at RBT this too is popped, restoring the 
original R5 and SP values. 



The next example involve 
itself). Its function i 
every left parenthesis e 
whenever a left parenthe 

following tt) . When a r 

executed and if the 
another is searched for. 
found, the HTK returns c 



s a recursive subroutine (one that calls 
s to look for a matching right parenthesis for 
ncountered. The sul>Eoiitlne is called by JSR 
sis is encountered CR2 points to the character 
ight parenthesis is found, an KTS PC is 
right parenthesis is tiot the last legal one, 
t-toen the final matching parenthesis is 
ontrol to the main program. 



MOVB (Ra) + #R0 
CMP #'(*R0 
BNE B 
JSR PC, A 
BR A 



iGET SUCCESSIVE CKARACTERS 
JLOOK FOR LEFT PARENTHESIS 
i FOUND? 

J LEFT PARE^i FOUND, CALL Sa,F 
I GO LOOK AT NEXT CHARACTER 
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Bl 



CMP8 #')j.R0 






A 
PC 



J LEFT PAREN NOT FOUND* LQ(K FOR 

J RIGHT PAREN 

tfomDl IF NOT# GO TO A 

1 RETURN PAREN FOIWO* IF NIOT LAST, 

J GO TO B, IF LAST* GO TO PlAIN 

J PROGRAM 



The example below illustrates the use of co-routines^ called by 
JSR PCj@(SP)+. The program uses double buffering on both input and 

output, psrforming an foliates! 



Writs 01 
iteM II 

Process I 1 



concurrently 



Write 02 
TiBad 12 

Pix5cess II 



concurrent ly 



JSR PC,3(RP)+ always perforns a jump to the address specified on top 
of the stack and replaces that address with the new return address. 
Each tiwe the JSR at B is executed, it jumps to a different location i 
initially to A and thereafter to the location following the JSR 
executed prior to the one at B, All other JSR's jump to B+2. 



BEGIN* 



PObIT 



IBO 1/0 RESETS* irsJlTS, ETC 



fit 



lOT 

.BYTE REAO*INSLOT 

. WORD I 1 

MIQV #A*-(6) 

JSR PC*»(6) + 



J READ INTO U TO START PROCESS 



UNITIALIZE STACK FOR FIRST JSR 
1 00 I/O FOR 01 AND I 1 OR OS 
I AND 12 
I PERFORM PROCESSING 



BR B 

tma or main loop 

J I/O CO- ROUTINES 
At lOT 

.BYTE READ,1^)SL0T 

. WORD I S 



IMORE I/O 



I READ INTO 12 



JSR PC, iC6) + 

lOT 

-BfTE WRITE, OUTSLOT 

.WORD 01 

lOT 

.BYTE REAO*INSLOT 

* WORD I I 



i SET PARAMETERS TO PROCESS 
II S* -01 

iRETUR4 TO PROCESS AT B*£ 
J WRITE FROM 01 



I REM) INTO I 1 



JSR PC,iC6>* 

lOT 

,mft WRITE* OUTSLOT 

.WORD OS 

iR A 



J SET PAR/^ETCRS TO PROCESS 
J I 2* 02 

J RETURN TO PROCESS 9*2 
J WRITE FROM 08 



IREAD INTO I a 



5-42 



The trap handler below simulates a two-worfl JSR instruction with a 
one-word TRAP instruction. In this exanple, all TRAP instructions in 
the program, take an operand and trap to the handler address at 
location 34, The table of subroutine addresses £e.g., A, a, ,..) can 
be constructed as fallovs: 



TABLEl 



CALA=. -TABLE 
.WORD A 

CALB=.- TABLE 
.WORD B 



J CALLED eVJ TRAP CALA 
I CALLED BYs TRAP CPLB 



Another way to construct the table ; 

TAiLEJ 



CALA=.- TABLE* TRAP 

.WORD A I CALLED Bft CALA 



The trap handler for either of the a^iove methods follows; 



TRAP34t rtOV f»SP*2<SP) 

SUB #2»«SP 

MOV »CSP)+^-<SP) 

ADD #TABLE-TRAP,tSP 

MQV 9CSP)+.PC 



I REPLACE STACKED PS MI TK PC* 

I SET POINTER TO TRAP 

JiNSTRUCTIOt*} 

; REPLACE ADDRESS OF TRAP WITH 

iTRAP JWSTRUCTIOM ITSELF 

I CALCULATE SUBROUTINE ADOR. 

J JUMP TO SyBROUTlNE 



*Replaoinq the saved PS loses the T-blt status. If 
a breakpoint has been set on the TRAP instruction, 
ODT will not gain control again to reinsert the 
breakpoints because the T-bit trap will not occur. 



In the example above, if the third instruetlon had been written 
J40V 8{RP} rCSP) it would have used an extra word since 8 CPP) is in 

Index Mode and asserf>les as SO(BP). In the final instruction, a jump 
was executed by a JdOV 3(RP) + ,PC, becuase no equivalent JI'IP instruction 

exists. 



Following are some Jiff* and MOV equivalences (note that 
affect condition codes). 



JI'IP does not 
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JW CR4) = MOV R4,PC 

JMP @CR4) = MOV CR4),PC 

(2 Words) {1 Word) 

None = MOV #CR4) ,PC 

JHP - C R4 ) = Hone 

JMP §{R4)4- = MOV CR4)+,PC 

JTIP @-(R4) = MOV -(R4) ,PC 

None = rWV iCR4H,PC 

Mone = rtJV §-(R4) ,PC 

JTIP X = MOV #X,FC 

JTIP @X = MOV X,PC 

None = MOV @x,PC 

The trap handler can also be useful as a patching teclinique. Junping 
out to a patcli area is often difficult because a tv;o-word jump must be 
performed, Hm^ever, the one-word TRAP instruction may be used to 
dispatch to patch areas. A sufficient number of slots for patching 
should first be reserved in the dispatch tal:jle of the trap handler. 
The jurap can then be accomplished by placinq the address of the patch 
area into the table and inserting the proper TRftP instruction where 
the patch is to be made. 



5.12 ASSEMBLY DIALOGFJE 

During assertLjly, the Asseitil>ler will pause to print on the console 
terminal various messages to indicate that some response must be made 
by the user before the ass<»pi)ily process can continue. CTRL/P may be 
typed at any time to stop the asserJily process and restart the initial 
dialogue, as nentioned in Section 5,1,3. 

If the specified assenJsly listing output device is the Line Printer 
and it is out of pap6r, the Assemliler prints on the terminal: 

EOM? 

and waits for paper to be placed in the device. Typing the RKTURN key 
will continue assemJ^ly. 

Other conditions which may cause the EOM? message for the line printer 
are; a) no power, b) printer drun gate open, and c) too hot. 

There is no HOM if the line printer is switched off-line, although 
characters may be lost for this condition as well as for an EOM. 

If the snd»of-tape is reached during cassette output and the user has 
not indicated an overflow file using the /O option, the Assenbler will 
print ! 

£CM? 

RETRf ? 

The user must mount a different output cassette and tJien type any 
character on the keyboard; the Assem}:)ler mil retry the same assembly 
using the new output cassette, Alternatively, the user can type +C 
and return to the KBL. (In systens greater tljan than SK, the user may 
also type +P, which returns control to the CBI, enabling another 
command string to be entered.) 
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If a hard read error is detected on one of the input files ^ the 
Assembler will prints 

tBAO TAPE 
RETW7 

Typing +C will return control to the KDL, Typing +P or any other 
character will cause the AssemJiler to retry the sane assertbly, CIn 
systems larger than 8K, the Assembler will return to the CSI and allow 
the user to input a new corttnand , ) 

If the last file does not have a .END, the Assembler will prints 

?N0 END ST»«T 

and will SFiulate a ,EKD assembler directive. Note that when ,END is 
emulated in this manner the error counter is incremented by one. 



5.13 ASSEMBLY LISTING 

The CAPS-11 Assembler produces a side-by-side assembly listing of 
symbolic source statements, their octal equivalents, assigned 
addresses, and error codes, as follows? 

CCAAAAAA OOOOOO'SSR S 

000000 

oooooo 

The C*s represent the error code field; error codes (listed in Table 
5~4) are flagged in this field. The A's represent the 6-bit octal 
address, while the 0*s r^pxesent the object data in octal. The S's 
represent the source stateinent, and ' represents a single apostrophe 
which will be printed whenever either the second, third or both words 
of the instruction will be modified by the Linker. The Assertsler 
accepts on input 72 (decinall characters per line. Any additional 
characters on the line will be ignored and the Assembler villi generate 
an 'L* error code. 

If an instruction requires two or three words, the second and third 
words of the statement are listed under the command word. No 
addresses precede the second or third words since the address order is 
sequential. The second and third words can be eliminated fron the 
assembly listing by means of the /X switch. 

The object data field of a .BYTE directive is assembled as three octal 
digits. 

The value of the defining expression in a direct assignment statertent 
is given in the object code field although it is not actually part of 
tlie code of the object progran. 

The .ASECT and .CSKCT directives cause the current value of the 
appropriate location counter (absolute or relocatable) to be printed. 
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Each page of the listing is h^acled by a PM. identification line and a 
page nimber (octal) , 

ftn example of an aaseiiti>ly listing is shoi-zn in Chapter ?, Section 7.6. 



5. 14 OBJECT MODULE OUTPUT 

The output of the afsaemiiler during the binary object pass is an object 
module which is meaningful only to the Liiiker. An overview of what 
this (*ject raodule contains and at what stage each part of it is 
produced follows. 

The binary object module consists of three main types of data block: 

1. Global Synlsol Directory (GSD) 

2. Text blocks (TXT) 

3. Relocation Directory (RLD) 



5,14,1 Global Synbol Directory 

As the nane suggests , the QSD contains a list of all the global 
symbols together with the name of the object module. Each syratool is 
in Radix 50 form and contains infornation regarding its mode and value 
whenever known. 

The GKD is created at the start of the binary object pass. 



5,14,2 Text Blocks 

The text blocks consist entirely of the binary oljject data as shown in 

the listing. Operands are in the unnodlfied form. 



5.14.3 Relocation Directory 

The RIjD blocks consist of directives to the Linker which may reference 
the text blocks preceding the RLD, These directives control the 
relocation and linking process. 

Itext and RLD blocks are constructed during the binary dbject pass, 
Outputting of each block is done whenever either the TXT or RLD buffer 
is full and vflienever the location counter needs to be Modified. 



'~N, 
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5.15 ERROR CODES 



The error codes printed beside the octal and symbolic code in 
assembly listing have the folloiv'lng meanings; 



the 



Table 5-5 
AssemJjler Error Codes 



,/•— *v 



Error Code 


Meaning 


A 


Addressing error. An address within the 
insitrnction is incorrect; may also 
indicate a relocation error. 


B 


Bounding error. Instructions or word 
memory data are being assembled at an 
odd address in memory, "The location 
counter is updated by +1. 


n 


Doubly-defined symbol referenced. 
Raferance was made to a symbol which is 
defined more than once. 


1 


Illegal character detected. Illegal 
characters which are also non-printing 
are replaced by a ? on the listing. 


L 


Line buffer overflot-/. Extra characters 
on a line (more than 72 C<3eciinal5 ) are 

ignored. 


n 


Multiple definition of a label. A label 
wan encountered which was equivalent (in 
the first six characters) to a 
previously encountered label. 


H 


Number containing 8 or 9 has decimal 
point missing. The nstmber is assembled 
as a decimal number. 


P 


Phase error, A lal^iel's definition or 
value varies from one pass to another. 


Q 


QuestionaljlG syntax. There are missing 
arguments, the instruction scan'^es not 
completed, or a carriage return was not 
immediately followed by a line feed or 
form feed* 


R 


Register~type error. An invalid use of 

or reference to a register has been 
made. 



(Continued on next page) 
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Talkie 5-5 (Cont. | 
Asseinhler Error Codes 






Error Code 


Meaning 


S 

T 
U 


Symbol tal>le o-i^erflow, Mhen the 
quantity of user-defined symbols exceeds 
the allocated space available in the 
symbol talkie, the Assembler outputs the 
current source line with the S error 
code, than returns to the Jtonitor Cor to 
the CSI in systens larger than 8K) , 

Truncation error. A number generated 
more than 16 bits of significance, or an 
expression generated more than 3 bits of 
significance during the use of the .BYTE 
directive, 

ttodefined symbol. An undefined syrtijol 
was encountered during the evaluation of 
an expression. Relative to the 
expresBion, the undefined symbol is 
assigned a value of zero. 



In addition to the error codes listed above, the following messages 
may also occur [error messages which are followed by a question mark 
allow the user to type a CTRL/C to return to tlie KBL or a CTRL/P to 
retry the operation) t 



Table 5-6 
Assemljler Error J-tessages 



1*3 sage 



f leaning 



%BAD CKD STRING 



?BAD TAPE? 



One of the following errors has 



occurred 

string! 



in the user's command 



No output was specified; 

No input was sped fled i 

Input and output were specified 

on the sa2!te drive? 

Input was specified from a device 

other than cassette j 

Binary output was specified to a 

device other than cassette. 

A checksum or other hard error 
occurred during a file lookup or 
enter copinand. Typing any 
character will cause the Asseirtfiler 
to retry the operation. 



(Continued on next page) 
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Table 5-6 
AsfsemJ.iler Error Ifessagea 



Message 



Meaning 



%BAD TAPE 



EOM? 



EOM? 
RKTRY? 



?FILE NOT FMD? 



?N0 END STMT 



7SWITCH ERROR! 'x'? 



TTAPE FULI*? 



A harrl read error was detected on 
one of the input files,* tvping any 
character (except CTRL/C) will 
cause the Assembler to retrv the 
same assembly (in systems larger 
than 8K, the Assembler will return 
to the CFI and allovr the user to 
input a new comand) , 

The line printer is out of paper or 
Is not powered upf the drum gate is 
open,* or the printer is too hot. 



Tha end of the tape was reached 
during cassette output anfl no 
overflow file was •5i«scified, The 
user nay mount another cassette and 
then tyt^e any keyboard character to 
instruct tlie Assemliler to retry the 
afssembly using the new output 
caBsette. 

The Assemliler coaltl not find one of 
the input files. The user may 
mount anotlier casfiette and type any 
ch.araater on tha keyboard to 
instruct the Assembler to retry the 
lookup on the sar^ drive. Typing a 
CTKL/P will restart the Asser#Jler 
(if the system is 8K the same 
asseinbly will he restarted, 
otherwise control will return to 
the CSI,3 

The file does not contain an .END 
directive; the AssGrJbler assumes an 
.END statement. 

An undefined option cJiaracter <x) 
was found in the command string. 

1^'ping any character on the 
keyboard will cause the Assembler 
to ignore the option and continue. 

The specified output cassette is 
completely full. Mounting a 
different cassette on the sai'^ unit 
and typing any character infstructs 
the Assembler to attaempt to open 
the file on a new cassette. 
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CHAPTER 6 

LINXIMG ASSEftDLED PBOGRAHS 



The CAPS-11 Linker converts object modules prc^iuced by the Assembler 
into a format suitable for loading and execution. This allows the 
user to assemble a large program in ge-g-eral sjsall subprograms or to 
separately assemble a main program and each of its subroutines without 
assigning an absolute load address at assembly time. Object inodules 
are processed by the Linker to: 

Belocate each object module and assign absolute addresses. 

Link the modules by correlating global symbols defined in 
one iftodule and referenced in another module. 

Print a load map which displays the assigned absolute 
addresses « 

Output a load module which can subsequently be loaded and 

executed* 

Advantages of using the CAPS-11 Assembler and the Linker include the 
following : 

1, A program is divided into segments {usually subroutines) 
whitrfi are assemtoled separately. If an error is discovered in 
one segment^ only that segment need be edited and 
reassembled- The new object module is then linked with the 
other object modules, 

2, Absolute addresses need not be assigned at assembly time as 
the Linker automatically assigns absolute addresses. This 
keeps programs from overlapping each other and also allows 
subroutines to change size without influencing the contents 
of other routines. 

3, Separate assemblies allow the total nuntjer of symbols to 
exceed the number allowed in a single assembly. 
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4, Since global syBibols are usually referenced from inore than 
one object module, the programmer Kust be sure that his names 
for such syjtsbols are unique between object modules* However, 

this does not apply when the symbol is internal r since an 
internal symbol ia referenced only from within the currant 
assembly, the same symbol names may he used in several 
different laodules, 

5. Subroutines nay be provided for general uae in object module 
form to be linked into the user's program. 



6,1 CALLING AMD USING THE LINKER 

The Linker is called from the Systein Cassette by typings 

.R LINK 

In response to the dot printed by the Keyboard Listener, The Command 
String Interpreter responds by printing Ein asterisk (*) at the left 
margin of the teleprinter paper. The user may respond with his I/O 

specifications as soon as the asterisk appears even though the 
remainder of the Linker is being loaded into t^irory simultaneously. 

The Linker requires two passes over the input object modules , During 
the first pass any undefined globals are listed on the console 
tenminal, and a global symbol table is constructed which includes all 
the control section niiiiHes and global symbols in the input modules. On 
the second pass, the Linker reads the object modules, performs most of 
the functions listed in the introductory description and produces a 
load module which can be loaded (using the »tonitor LOAD ccmmand) and 
executed. !Mie load module is output in binary image format, 

lifter execution, control returns to the CSl, indicated by an asterisk 
at the left margin? the user may enter another command string. 



6.1,1 Linker Options 

The options listed in Table 6-1 are available for use by the Linker 
and are designated by the user in the I/O specification linei 
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Table 6-1 
Linker Cations 



Option 



ffeatiiag 



/C 



/P 



/O 



/P 



/s 



This option alleys the I/O specification 
line to be broken into several segiaents. 
The option character is follcwed 
iPBBediately by a carriage return and the 
I/O specification is continued on the 
next line; this line must begin with a 
coT^nrta « 

This option is valid only attiex an input 
filename and Indicates that the Linker 
should not perform a IffiS*IND operation 
but should continue searching the 
cassette in a forward direction for this 
file. This feature saves the user time 
when he wishes to input several files 
from one cassette and these files appear 
on that cassette in the same order as 
they are to be linked. The /P option 
prevents the Linker from performing a 
HEWIND before accessing each file. 

This option is valid only after an 
output filename and indicates that the 

file (immediately preceding the option) 
ia to be created and used only if a 
previously opened output file has been 
written to the end of a cassette and 
more output remains, All output files 
can later be combined under one nanie 
using PIP (see Chapter S) , 

This optical is used whenever a file 
referenced in an I/O specification line 
ia on a cassette which ia not currently 
mounted on the unit drive. Before 
attempting to search for the file^ the 
Linker instructs the user to mount the 
proper cassette on the drive by printing 
#? where # represents the drive number. 
After the user has switched cassettes on 
the drive, he may continue execution by 
typing any character on the keyboard. 

This option is valid only after an input 
filename and indicates that two or more 
object modules have been combined (using 
PIP) under the single filename. The 
option instructs the Linker not to skip 
to the next input filename until it has 
obtained all necessary information for 
the files included in the first. 



(Continued on next pagej 
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Table 6-1 (Cont,) 
Linker Options 



Option 


Meaning 


/Bsn 
/Hjn 


The /T option is valid only after an 
input filename and Indicates that the 
transfer address of ifchis particular 
object module is to be used as the 
transfer address of the final load 
module. If more than one /T option is 
indicated in the I/O specification line, 
only the last one is significant. 

The program is to be linked with its 
lowest location at n. If n is not 
specified, the Linker assumes location 
€00. (The Monitor uses locations 
400-600 for stack space while loading is 
in progress, so the user should not 
atteR?>t to link any data for loading 
into that area,) 

The progrMt! is to be linked with its 
highest location at n. If n is not 
specified, the Linker assumes that the 
last location of the user program will 
go just under CLODll (see Chapter 3, 
Figure 3-l>. The user can then use the 
LOAD/G command to txm his file. 



NOTE 

If neither the /B or /H options are 
indicated (or if both are indicated) , 
the Linker will load the program with 
its highest location just belo%? the KBL, 
ao that the entire CAPS-11 itonitor will 
be preserved. 

The Linker does not give a warning if a 
program is linked in memory in such a 
way that its lowest address falls below 
address 0. However, this condition can 
be easily recognized by examining the 
low and high limits which are always 
printed in the load map. 



If the user wishes to link his program for an overlay load (via the 
LCB^D/0 cCTMnand) , he can link it using the /B switch with no value. 
The loiiter limit is set to 600 and the Linker will set the high limit 
to allow just enough rr^ciory for CABLDR and CBOCV (which the user needs 
to load his program and to re-boot the CAPS- 11 System) . The .LIMIT 
assembler directive (see Chapter 5) can be used to instruct the Linker 
to load the value of the high limit into the user-program. If the 
user wants to link hia program at the top of memory, he should use the 
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/K switch designating a value which is 1214 (octal) bytes less than the 
number of bytes in his machine. For an 8K system this would be 
40000-1214 or 36564 (octal) ; the program would then be linked using 
/K:36564. 

( 



6.1.2 Input and Output Specifications 

The Linker allows two output specifications , one for binary output and 
one for the load map output. Inserting only a comma for either output 
specification instructs the Linker that no output of this type is to 
be produced. Any number of input files are acceptable. The format of 
the I/O specification line is: 

*DEV: FILENA . LDA/OPT , DEV: FILEHA . MAP/OPT=DE V: INPUTl . OBJ/C 
,DEV;INPUT2.0BJ/OPT, . . . DEV: I NPUTn. OBJ/OPT 

DEV represents one of the CAPS-11 1/0 devices; OPT represents any of 
the options listed in Table 6-1. Unless otherwise indicated, the 
Linker assumes the extension .LDA for the binary output file, .MAP for 
the load map output, and .OBJ for the relocatable binary object module 
input files. 

For example, consider the following 1/0 specification lines: 

.R LINK 

*CT1 1 PROG* LP: »0: RES, TYPE. 3RM/F* 0: SI GN/P/C 

*TABLE. DAT/F/H: 2000 

This command line causes the Linker to output the load module 
(PROG. LDA) on cassette drive 1, and the load map on the line printer; 
the input files are RES. OBJ and TYPE.3RN, both on cassette drive 
(the /F option indicates that TYPE,3RN follows RES. OBJ on the cassette 
and that no rewind is necessary) ; the next input file (SIGN. OBJ) is on 
a cassette which is not currently mounted, so the user asks to be 
prompted (via the /P option) when the file is needed; the command 
string is continued on the next line, and the final input file is 
TABLE, DAT which is in a forward direction (in relation to SIGN, OBJ) on 
the cassette now mounted on drive 0. The program (PROG. LDA) is linked 
so that its highest address is at location 2000. 

.R LIMK 

;*TT:»ACE. 1*BAK.0BJ 

In this example, no output load module is created; the load map is 
output to the console terminal; the input files are ACE.l and BAK.OBJ, 
both on cassette drive 0. The cassette is rewound before BAK.OBJ is 
accessed. Since no linking address is specified in the command line, 
the program is linked so that its highest location will load just 
below the KBL, preserving the entire CAPS-11 Monitor. 



6.1.3 Restarting the Linker 

The Linker may be restarted at any time (while it is memory) by typing 
CTRL/P. This echoes as +P followed by a carriage return/line feed. 
Control is passed back to the Command String Interpreter and the user 
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may input a new conmand string. (An exception occurs when typing +P 
while the load map is being output--this causes the Linker to 
terminate the map imaediately and start Pass 2.) 



6.2 ABSOLUTE MID RELOCATABLE- PROGRAM SECTIONS 

AS explained in chapter 5, the programmer may designate sections of 
hia program as absolute or relocatable by means of the ,ASECT and 
.CSECT assembler directives. (The Linker assumes .CSECT if neither 
directive is indicated.) In an absolute section, a direct assignment 
statement of the form .=EXPRESS10N initially assigns an absolute 
address to an instruction; succeeding instructions and data in the 
absolute section are then assigned absolute addresses in accordance 
with the assembly location counter. 

Instructions and data encountered in relocatable sections are assigned 
absolute addresses by the Linker. These addresses are normally 
assigned such that the relocatable sections are loaded Just below the 
lowest location of the KBL {although the user can control this with 
the Linker /B and /H options) , All instructions and data which the 
prograramer has designated in a relcKiatable section (called a control 
section and indicated by a .CSICT directive) are mcxaified 
appropriately and as necessary by the Linker to account for their 
relocation. 



6,2.1 Named and Unnamed Control Sections 

The Linker has the capability of handling named and unnamed control 
sections, (Assigning names to control sections is a feature not 
supported by the CAPS- 11 Asseirtoler, although the programmer may have 
occasion to use other assemblers which do allow this feature.) An 
unnamed control section (which is actually assigned a special default 
name of 6 blanks, i.e., .CSECT ) is internal to each object 
module and is treated independently from any other unnamed control 
section. The Linker assigns each unnamed section an absolute address 
such that it occupies an exclusive area of memory. Named control 
sections, on the other hand, are treated globally. That is, if 
different object modules have control sections with the same name, 
(for example, .CSECT DATA) , they are all assigned the same absolute 
load address and the size of the area reserved for loading of the 
section is that of the largest. Thus, named control sections allow 
for the sharing of data and/or instructions among object modules. A 
restriction is that the name of a control section must not be the siyaie 
as the name of a gl<4>al entry symbol as this will result in multiple 
definition errors. 

The jdbsolute section is always assigned the special name .AfiS (i.e., 
.ASECT.ABS) by the Linker. 






6.3 GLOBAL SYMBOLS 

Global symbols provide the links, or coramunlcation^ betweesn object 
nwdules. Global syribols are created with the .GIjOBL asseiiilsler 
directive (as described in Chapter 5) . Symbols which are not global 
are called internal syrabols. If the global symbol is definesd in an 
object module (as a label or ^ direct assignmentj it ia called an 
entry symbol and other object roodules can reference it* If the flobal 
symjiol is not defined in the object module^ it is an extewial symbol 
and is assumed to be defined {as an entry 3yi!4>ol) In some other object 
module . 

As the Linker reads the object modules it keeps track of all global 
symbol definitions and references. It then modifies the Instructions 
and/or data which reference the global symbols. Undefined globals are 
printed on the console terminal during pass 1. 



6.4 IWPOT AND OUTPUT 

Linker input and output is in the form of modules; one or more input 
modules (object modules produced by the Assembler) are used to produce 
a single output (load) module. 



6.4,1 Object Modules 

Object files, consisting of one or more object modules, are used as 
input to the Linker; these object modules have been previously created 
by the Assembler, and more than one object module may have been 
combined using PIP to form a single object file. The Linker reads 
each object nKjdule twicei that is, it is a two-pass processor. During 
the first pass, each object module is read so that absolute addresses 
can be assigned to all relocatable sections and all globals can be 
assigned absolute values. The information the Linker needs for this 
process is contained in the global symbol directory (GSD) , located at 
the beginning of each object mcwiule. Unless the /S switch has been 
indicated in the command line, during the first pass the Linker reads 
only the GSD at the beginning of the object file. 

On the second pass, the Linker reads the object modules, links and 
relocates the modules, and outputs the load module. During this pass 
it uses a block of information output by the Assewibler in the object 
file which is called the Itelocation Directory (pld) , 



6.4.2 Load Module 

The primary output of the Linker is the load module which may be 
loaded and run under the CAPS-11 Keyboard Monitor. The load module 
consists of formatted binary blocks holding absolute load addresses 
and object data. The first few words of data will be the 
communications directory (COMD) which will have an absolute load 
address equal to the lowest relocated address of the program, CABLDR 
or CLODll will load the COMD at the specified address but the COMD 
will then be overlayed by the program. The end of the module will be 
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indicatecl by a TEA block; that is, a block containing only a load (or 
transfer) address. The byte count In the formatted binary block will 
be 6 on this block; on all other blocks the byte count will be larger 
than 6. The TRA is normally selected by the Linker to be the first 
even transfer address seen. Thus, if four object modules are linked 
together and if the first and second had an <end statement, the third 
had a *END A and the fourth had a .END B, the transfer address would 
be A of module three. However, the user can specify directly which 
transfer address is to be used by the Linker via the /^ option as 
described in Table 6-1, 



NOTE 



The overlaying of the 
relocated program is a 
allows CABLDR to handle 
with a COMD. However, a 
if a load module is to 
CABLDR and either of 
conditions is tnie: 



COMD by the 
method which 
load modules 
problem arises 
be loaded by 
the following 



1. The object modules used to 
construct the load module 
contained no relocatable code? 

2, The total size of the 
relocatable code is less than 
32 {103 bytes (the size of the 
COMD) - 

In either case, there is not enough 
relocatable code to overlay the COMD 
which raeans the COMD will load into 
parts of memory not intended to be 
altered by the user. The COMD's load 
address, selected by the Linker in the 
above cases, is 400 (octal). This area 
is reserved for the Monitor stack while 
loading is in progress, so no user data 
should be destroyed when the COMD is 
loaded there. 



6*4.3 Load Map 

The load map provides several types of information concerning the load 
module's make-up. Tlie map begins with an indication of the low and 
high limits of the relocatable code and the transfer address. Then a 
section of the map is allocated for each object module Included in the 
linking process. Each of these sections begins witJi the module's name 
followed by a list of the control sections and tJie entry points for 
each control section. The base of each control section (its low 
address) and its size {in bytes) is printed to the right of the 
section name (enclosed in angle brackets) . Following each section 
naiae printout Is a list of entry points and their addresses* After 
all information has been printed for each object module, any undefinad 
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symbols are listed. Note that modules are loaded such that if issodulea 
A, B and C are linJced together, A is lov^ast and C is highest in 
memory. 

The foatmat is self-explanatory and is illustrate*! in Section 6,6. 



NOTE 

A CTRL/O typed during output of the 
Linker load map is treated s<srffiv*hat 
differently than during normal CTHL/O 
usage. If the user does not wish to 
list all entry points when the map is 
being output on the console tezisinal, 
typing +0 will suppress output of tha 
load map until the beginning of the 
section for the next paodulej the Linker 
will then automatically restart the load 
map output for this module. 



6,5 ERROR nEsgj^QEg 

The following messages are printed by the Linker whenever it detects 
am error during the linking process. Two types of errors may 

occur— fatal and non-fatal. 



6.5,1 Non-Fatal Errors 

Table 6-2 lists errors which can occur withoijt causing an interruption 

in the linking process. 



Table 6-2 
Linker Non-Fatal Error Messages 



Message 


Meaning 


?BAD TAPE? 

?BfTE FBBLOC EKSDR AT 
ABS ADDRESS xxxxxx 


A checksum or other hard error 
occurred during a file LOOKUP or 
EfJTER coramand. Typing any 
character will cause the Linker to 
retry the operation. 

This message designates a byte 
relocation error. The Linker will 
try to relocate and link byte 
quantities; however, relocation 
will usually fail and linking may 
fail, (Failure is defined as the 



(Continued on next page) 
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Table 6-2 (Cont.) 

Linker Non-Fatal Error iyiessages 



Message 



Meaning 



7FILE MOT FND? 



?MAP DEVICE EOM? 



?MODULE NAME xxxxxx 
NOT UNIQUE 



? SWITCH ERROR! 'x'? 



?TAPE FOLL? 



high byte of the relocated value or 
the lirtked value not being zero.) 
In such a case, the value is 

truncated to 6 bits and the error 
message is printed to inform the 

user. The Liiiker then 

autc»natically continues. 

The Linker could not find one of 
the input files. This Is generally 

caused when the wrong cassette is 
mounted on a dri^^. Upon 
occurrence of the message, the user 
may mount the correct cassette; 
typing any character on the 
keyboard will cause the Linker to 
retry the LOOKUP on the same drive. 
Typing a CTRL/F will restart the 
Linker f typing a CTRL/C will cause 
a return to the Monitor. 

The Load Map device EOM error 
allows the user an option to fix 
the device and continue or abort 
the map listing. Typing a carriage 

return (or any other charact:er) 
causes the Linker to continue (if 
the map device was cassette, the 
map listing is continued on the 
console terminal) j a +P will cause 
the map to be aborted. 



This error is detected during pass 
1 and results from a non-unique 
object module naine. The module is 
rejected and the Linker will then 
ask for more input. 

An undefined option character (x) 
was found in the coflfflnand string. 
Typing any character on the 
keyboard will cause the Linker to 
i^ore the option and continue. 

The specified output cassette is 
full. Mounting a different 
cassette on the same unit and 
typing any character instructs the 
Linker to attempt to open the file 
on the new cassette. 



(Continued on next page) 
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Table S-2 <Cont.) 
Linker Non-Fatal Error Messages 



1 

Message 


Meaning 


?XXXXXX MULTIPLY DBFINED 
BY MODULE xxxxxx 


This message results during pass 1 
if globals have been defined more 
than once. S»e second definition 
is ignored and the Linker 
continues. 



6.5.2 Fatal Errors 

The following errors are fatal and cause control to return to tJbm 

Monitor > 



Table 6-3 
Linker Fatal Error Messages 



Message 


Meaning 


%BAD CHD STRING 


One of the following errors has 

occurred in the user's command 




string: 




No output was specifiedi 




No input was Specified; 




Input and output were specified 
on the same drive; 




Input was specified from a 
device other than cassette; 




Binary output was specified to a 
device other than cassette. 


%CAS. CHECKSUM 


A checksum error was detected while 
reading a cassette block. 


%ODD ADDRESS 


An odd address was specified using 
the /B or /H options in the ccjminand 
string. 


%SYKBOL TABLE OVERFLOW- 
MODULE xxxxxx, SYMBOL 

xxxxxx 


A symbol table overflow has 
occurred (the 8K Linker has room 
for approximately 225 (declraal) 
symbols) . 



(Continued on next page) 



6-11 



Table 6-3 (Cont.) 
Linker Fatal Error Messages 



HBSS8,ge 



Meaning 



^SYSTEM ERROR XX 



A system error has occurred i xx 
represents an identifying nui^nber 
from the follcsiing liatj 



01 






03 



04 



05 



Unrecognized 
entry found* 



oyisijol table 



A relocation directory 
references a global na^e which 
cannot be found in the syndaol 
table. 

A relocation directory 
contains a location counter 
modification coitimand which is 
not last.. 

Object module does not start 
with a GSD* 

The first entry in the GSD is 
not the nodule name. 



06 A Relocation Directory (KLD) 
references a section name 
which cannot be found, 

07 The transfer address (tra) 
specification references a 
non-existent module name. 

08 The transfer address (TRA) 
specification references a 
non-existent section name, 

09 Im internal Juinp table index 

is out of range, 

10 A checkstiKi error occurred on 
the object module, 

11 An object module binary block 
is too big <more than 
64 (decimal) words of data) . 

12 A device error occurred on the 
load module output device. 



All system errors except number 12 indicate a program failure either 
in the Linker or the program which generated the c^ject module. Error 
05 can occur if a file is read which is not an object mc^ule. 






6,6 EXAMPLE USING T?!E LINKER 

The following example demonstrates how the user can link the PAL 
Assembler for cin 8K system. A load map is produced on the console 
terminal, and the load module is output to cassette drive 1 as 
PAL8.SRU. (Refer to Appendix E for complete instructions on how to 
build systems for any configuration.) 



.R LINK 

* 1 1 PALS . SRU, TT: -PAL 1 I S« PAL8KS/F« CSI TAC /F/Bi -400 

CAPS- I 1 LINK V01 
LOAD MAP 

TRANSFER ADDRESS] 0027 54 

LOW LINITt 000400 

HIGH LIMIT! 030544 

******** 

PAL 

SECTION ADDRESS SIZE 



COLLI D 


000150 


RESREG 


104124 


SAVERE 


104122 


STSIZE 


001312 


< 


> 


000400 


020222 










ASCII 


007064 


ASECT 


006232 


BYTE 


007202 


CSECT 


006146 


END 


010074 


ENDC 


00607 6 


EOT 


006566 


EVEN 


00667 6 


GLOBL 


006324 


IFDF 


005712 


IFG 


005616 


IFGE 


005620 


IFL 


005622 


IFLE 


005624 


IFNDF 


005716 


IFNZ 


005614 


IFZ 


005632 


LIMIT 


007 002 


LIST 


006130 


NLIST 


006136 


RAD50 


007 042 


TITLE 


006520 


WORD 


007172 






******** 














PALSYM 
















SECTION 




ADDRESS 


SIZE 










< 1 


» 


020622 


0047 3 










CHAR 13 


020622 


CHAR4 6 


022134 


DOTFLG 


025323 


FLAGS 


0247 60 


I DOT 


024354 


SVALUE 


023446 










******** 














CSI TAC 
















SECTION 




ADDRESS 


SIZE 










< 1 


^ 


025526 


003016 










BAD EX I 


026460 


CSI TAC 


025530 


ERRCOM 


026350 


HDRBUF 


027 504 


IGNRFU 


025526 


IN OUT 


02SSS4 


MESOUT 


027214 


MESRES 


027210 


NMBUF0 


026662 


SWMSFL 


026064 


TYPE00 


026673 


TYPE01 


026733 



PASS 2 
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CHAIT^ER 7 
DEBUGGING THE OBJECT PROGPIAM 



ODf (On-line Debugging Technique) aids the user in debugging assembled 
and linked object programs. Using the console terminal keyboard, the 
user interacts with OUT and his object program to: 

Print the contents of any location for examination 
or alteration 

Run all or any portion of the object program using 
the breakpoint feature 

Search the object program for specific bit patterns 

Search the object program for words which reference 
a specific word 

Calculate offsets for relative addresses 

Fill a block of words or bytes with a designated 
value 

During a debugging seasion, the user should have at the console 
terminal an assembly listing of the program to be debugged. Minor 
corrections to this program can be made on-line and the program raay 
then be run under asntrol of ODT to verify any change made. However, 
major corrections such as a missing subroutine should be noted on the 
assembly listing and incorporated in a subsequent updated prograin 
asseinbly. 



7.1 CALLING AMD USING ODT 

ODT is supplied as a relocatable object module and is also stored on 
the System Cassette. It is linked so as to be loaded just under the 
KBL (refer to Appendix B) r the procedure for loading ODT and the user 
program iss 
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• LOAD F1LI>IA. EJCT 

. i ODT 

These commands load the user-program to be debugged into memory and 
call and start the debugger. This is the m^st cssmmon form of ODT use, 
aa it is expected that user programs will start in low memory and that 
the standard location of ODT will suffice. However, the ugsr may 
alternatively relink ODT using the CAPS-11 Linker, or link ODT along 
with his program. 



7.1,1 OCT Options 

"Hie only options allowed are those used by the IX)AD command when the 
user program is loaded into mentory, ODT itself dc^s not utili^^e the 

^C T 



7.1»2 Input/Output Specifications 

The input file is indicated in the JjOAD command. No output file 
specifications are allowed, ODT is an on"line utility program which 
aids the user in determining corrections and modifications to his 
program; these corrections may then be implenented using the Editor 
and Aasentoler. 



7.1.3 Restarting ODT 

If ODT is in control, typing CTRL/P \vill restart ODT (indicated by an 
asterisk at the left margin) , renoving all breakpoints and clearing 
all relocation registers. If the user program is in control and no 
breakpoint or HAIiT instruction is encountered to stop program 
execution, then ODT may be restarted by following one of the 
techniques described in Section 7.4,2, 



7.2 RELOCATION 

The Assembler produces a binary relocatable object module; the base 
address of this module is assuFied to be location 000000 and the 
addresses of all program locations as shown in the assesibly listing 
are indicated relative to this base address. After the module is 
linked by the Linker, many values within the program and all the 
addresses of locations will he incremented by a constant whose value 
is the actual absolute base address of the module after it has been 
relocated. This constant is called the relocation bias for the 
module. 

A linked program may contain several relocated modules each with its 
own relocation bias; since, in the process of debugging, these biases 
will have to be subtracted from absolute addresses continually In 

order to relate relocated code to assembly listings, ODT provides an 

autcanatic relocation facility. 






The basis of the relocation facility lies in eight relocation 
registers nuirftjiered through 7 (these should not be confused with 
general registers 0-7) which may be set to the values of the 
relocation biases at any given time during debugging (thia procedure 
is explained in Section 7,3.13), Relocation biases are obtained by 
consulting the memory map prt>duced by the Linker. Cnce set, a 
relocation register is used by ODT to relate relocatable code to 
relocated codte» The relocation registers are initialized by OiOT to 
-I* (For more Information on the exact nature of the relocation 
process, consult Chapter 6.) 



7,2.1 Relocatable Expressions 

A relocatable expression is evaluated by ODT as a 16-bit (6 octal 
digit) ituinber and may be typed in any one of the three forms presented 
in Table 7-1. In this table, n represents an integer in the range 
to 7 Inclusive and k stands for an octal nran^ser of up to six digits in 
length with a maximum value of 177777. If more than six digits are 
typed, OOT uses the last six digits truncated to the low-order 16 
bits, k may be preceded by a minus sign, in which case its value is 
the two's complement of the nuirfcer typed. Pot examples 



k (number typed) Value 



400 

-177730 

1234567 



OOOOOl 
177777 
000400 
OOQ050 
034567 



Table 7-1 
Forms of Relocatable Expressions (r) 



r 


Value of r 


a) k 

b) n,k 

c) c or 
c,K or 

n,C or 
C,C 


The value of r is simply the 
value of k. 

The value of r is the value of 
k plus the contents of 
relocation register n. If the 
n part of this expression is 
greater thajh 7, ODT uses only 
the last octal digit of n. 

Whenever the letter C is 
typed, ODT replaces C with the 
contents of a special register 
called the Constant Itegister. 
This value has the sarre role 
as the k or n that it replaces 
(i.e., when used in place of n 
it designates a relocation 
register). The Constant 
Register is accessed by t:^ing 
the synJsol ?C and may be set 
to any value. (See Section 
7,3.10.) 
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In the following examples , assume that relocation register 3 
003400 and that the Constant Register contains 000003 j 



contains 



5 

-17 

3,0 

3,150 

3,-1 

C 

3,C 

C,0 

c,io 
c,c 



Value of r 
ooooos 

177761 
003400 
003550 
003377 
000003 
003403 
003400 
003410 
003403 



NOTE 

For simplicity's sake, most examples in 
this section use form aj all three forms 
of r are equally acceptable, however. 



7«3 COMMANDS AND FUNCTIONS 

After ODT is loaded and started it indicates its readiness to accept 
commands by printing an asterisk (*) at the left margin of the console 
terminal paper. Most OBT commands are issued in response to the 
asterisk and are composed of the characters and symbols shown in this 
section. By using ODT a word can be examined and changed, the object 
program can be run in its entirety or in segments if and memory can be 
searched for certain words or references to these words. Each command 
is explained in detail here? a command surnary is provided in Appendix 
C. 



7,3.1 Printout Formats 

Normally, when OOT* prints addresses it attempts to print them in 
relative form {form b in Table 7-1), ODT assumes the user has set the 
relocation registers with the relocation biases and checks for the 
register whose value is closest but less than or equal to the address 
to be printed. It then represents this address relative to the 
contents of the relocation register. However, if no relocation 
register fits the requirement (that is, the user has not entered the 
relocation biases for his object modules) , the address is printed in 
aljsolute form (form a in Table 7-1), Since the relocation registers 
are initialized to -1 {the highest number) the addresses are initially 
printed in absolute form. If any relocation register subsequently has 
its contents changed, it may then, depending on the command, qualify 
for relative form. 
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For exanple, suppose relocation registers i and 2 contain 1000 and 
1004 respectively, and all other relocation registers contain numbers 
much higher. Then the following sequence might occur (the slash 
command causes the contents of the location to be printed; the line 
feed ccanraand il) accesses the next sequential location) s 



•77 4/e 

i* 000000 /000egg t {absolute location 1000) 
UBmBBS /0fl000a i (aljsolute location 1002} 
S# 090000 /0g000g {absolute location 1004) 

The printout format is controlled by a special register called the 
Format Begister. Initially, this register is get to which instructs 
ODT to print addresses relatively whenever possible. However, the 
user may access the Format Jtegister by typing $P, thus allcw^ing the 
register to be modified. By changing the contents to any non-zero 
value, the user instructs ODfT to print all addresses in absolute form. 



7,3.2 Opening, Changing, and Closing Locatione 

An open location is one whose contents ODT has printed for 
examination, making those contents available for change; a closed 
location is one whose contents are no longer available for change. 
Several commands are used for opening and closing locations. 

Any command used to open a location when another location is already 
open first causes the currently open location to be closed. The 

contents of an open location may be changed by typing the new contents 
followed by a single character command which requires no arguwent 



(i.e., I , +, RETURN, +, @, >, <). 



The Slash, / 

a location is opened by typing its address followed by a slash. ODT 
responds by printing the contents of the location j for example! 

* 1000/012746 

Location 1000 is open for examination and is available for change. 

If the contents of an oj^n location are not to be changed, typing the 
RETTON key causes the location to be closed? ODT prints an asterisk 
and waits for another command. 

To change the contents of a location, the location must first be 

opened, the new contents are then entered, and finally a command li? 
given to close the location. 

* 1000/ 0127 ^a 01 2345 J 

i 

In the example above, location 1000 now contains 012345, The location 

is closed since the RETURN key was typed after entering the new 

contents . 
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Used alone, the slash reopens the last location opened. For examples 

♦ l900/0i23j35_2340 J 

?/ 00g34 | 

ODT changed the contents of location 1000 to 00234Q; the MOTURN key 
instructed ODT to close the location before printing the *, The 
single slash command reopened the last location opened , allowing the 
user to verify that the word 002340 was correctly stored in location 
1000, 

Note that if an odd numbered address Is specified using a slash, ODT 
opens the location as a byte, and stj^sequently behaves as though a 
backslash had been typed, as explained next. 



The Backslash, v 

In addition to operating on words, ODT may operate on bytes. One way 
to open a byte is to type the address of the byte followed by a 
backslash, (\ is printed by typing a SHIFT/L if uBing an LT33 or 35) , 
OUT not only causes the byte value at the specified address to be 

printed, but also interprets the value as ASCII code and prints the 
corresponding character (if possible) on the terminal. For examples 

y|g01 M01 g!A 

A backslash typed alone reopens the last byte opened. If a word was 
previously open, the backslash reopens its even byte, 

* 1082/000004 \004 5 



•me LINE FEED l^y 

If the LINE FEED key is typed when a location is open, ODT closes the 

open location and opens the next sequential location: 

* 1000/ 002340 i ( \ denotes typing the LINE 
00ia§a /0ieT40 feed keyj 

In this example, the IiINE FEED key caused ODT to print the address of 
the next location along with its contents , and to wait for further 
instructions. Location 1000 is automaticaly closed by ODT and 1002 is 
opened. The open location raay be modified by typing new contents. 

If a byte location is open, typing the LINE FEED key opens the next 
byte location. 



The Up-ftrrow, + or A 

If an up-arrow Cor circianflex) syrobol is typed when a location is open 
(an up-arrow is produced by typing a SHIFT/N on an LT33 or 35) , ODT 
closes the open location and opens the previous location. To continue 
from the example above; 
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♦ 00 1 002/01Sr40_t 
001000 /00e340 



Now location 1002 is closed and 1000 is open. 
be modified by entering new contents. 



The open loeation may 
If a byte location is open, then up-arrow opens the previous byte» 



ThB Back-arrow,*- or _ 

If the back- arrow {or underline) syi^ol (produced by typing SHIFT/O on 
a Lf33 or 35} is typed when a location is open,. ODT interprets the 
contents of the currently open word as an address indexed by the 
Prograra counter (PC) and opens the location so addressed: 

» 1006/ 000006 *• 
001016 /i0040S 

Notice in this ex^nple that the open location, 1006, was Indexed by 
the VC as if it wer& the operand of an instruction with address nKKle 
67 as explained in Chapter 5. 

Modification to the opened location may be made before either a line 
feed, up-arrow, or back-arrow is tyr«d. Also, the new contents of the 
location will be used for address calculations when using the 
back-arrow command. For example; 

»100/ 000aga Aj (modify to 4 and open next location) 

000102 /0001 1 1 6t {modify to 6 and open previous location) 

000100 /000004 100- {change to 100 and open the location 

000g0a /{content s) indexed by PC) 



Open the Addressed Location, 3 

The symbol @ (SHIFT/P on an LT33 or 35) may be used to optionally 
modify a location, close it, and then use its contents as the address 
of the location to open next. 



♦ 1006/ 00 1 02-4 a 
001024 /00050e 



(open location 1024 next) 



» 1006/ 001084 a i00i 
00SI00 /miTA 



(modify to 2100 and open 
location 2100) 



Relative Branch Offset, > 

Hie right angle bracket C >) allows the user to optionally modify a 
location, close it, and then use its low-order byte as a relative 
branch offset to the next word to be opened. For examples 
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*l03g /g@0407 30 IJ 
00063« /0000I0 



(iftodify to 301 and interpret as a 
relative branch) 



Note that 301 is a negative offset (-77) . The offset 
before It is added to the PC? therefore, 1034+ (-17G) =636. 



is doubled 



Return to Previous Sequence, < 

The left angle bracket ( <} allows the user to optionally modify a 
location, close it, and then open the next location of a previous 
sequence which was interrupted when either a back-arrow, 8 sign, or 
right angle bracket command was uned. (As already mentioned,-^ , §, 
and > each cause a sequence change determined by the contents of the 
open location. If a sequence change has not occurred, the left angle 
bracket simply opens the next location as though using a line feedj , 
This command og^rates on both words and bytes.' For examples 



•t032/0004|7_301> 
000636 /fl000I0 < 

001034 /0g|040 e 
301040 /0e0405 \0es = < 

001035 \g0g g < 

001036 \004 = 



(> causes a sequence change) 
(return to original sequence) 
(9 causes a sequence change) 
(< now operates on byte) 
£< acta like | ) 



7.3.3 Accessing General Registers 0-7 

The program's general registers 0-7 are opened using the follcs/ing 
command format; 

*$n/ 

where n is an integer in the range through 7 and represents the 
desired register. When opened, these registers can be examined or 
changed in the same manner as any addressable location. For example: 

* 10/0000033^ (iRO was examined and closed) 

# 

;S4/ g004?4 . 464^ ^j^^ ^^^ opened, changed, closed,) 
S^MSL^il. (and verified) 

The j f'^ ,'*^ , or @ commands may be used whenever a register is open. 



7.3,4 Accessing Internal ftegisters 

The progran's Status Register contains the condition codes of the most 
recent operational results and the interrupt priority level of the 
object program. The address of this register in accessed by typing 
$S. For example: 

*ss/i003n 
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In response ta $S/ in the example above, ODT printed the 16-blt word 
of which only the low-order 8 bits are meaningful^ Bits 0-3 indicate 
whether a carry, overflew, zero, or negative (in that order) value has 
resulted, and bits 5-7 indicate the interrupt priority level (in the 
range 0-7) of the object program. (Refer to the PDP-11 PROCESSOR 
HANDBOOK for the Status Register fontvat.) 

Table 7-2 lists internal registers which may be opened using the $ 
format . 



Table 7-2 
Internal Registers 



j Registerj 


Function 


1 f 

SB 


Location of tiie first word of the breakpoint 
table (see Section 7.3.6). 


$M 


Mask location for specifying which bits are 

to be examined during a bit pattern search 
(see Section 7.3.9). 


$P 


Location defining the ot;^rating priority of 
OCW (see Section 7.3.15). 


$S 


Location containing the condition codes {bits 
0-3) and interrupt priority level {bits 5-7) j 
(explained above) . 


$C 


Location of the Constant Register (see 
Section 7.3.10). 


$R 


Location of Relocation Jtegister 0, the base 
of the Relocation Register Table (see Section 

7.3.13). 


$F 


Location of Format Register (explained in 
Section 7.3.1). 



7.3.5 Radix SO Ntode, X 



enployed by 
directive. 



the Radix 50 mode of packing certain 
is employed by many DEC- supplied 
any programmer using 
ODT allows a method 
words packed in this way by providing 
is typed when a location is open, 
opened word to its 3-character Radix 
characters on the terminal. One 
then be typed: 



ASCII characters three to a word 
PDP-11 system programs and may be 
the CAPS- 11 A9sen4)ler*s ,RAD50 
for examining and changing nieraory 
the X command. If the X command 
ODT converts the contents of the 
50 equivalent and prints these 
of the responses in Table 7~3 may 
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Table 7-3 

Radix 50 Terminators 



Response 


Effect 


RETURN key 
LINE PEED key 

Ue>™ Arrow key 

Any three 
characters whose 

octal code is 040 
(space) or greater 


Close the currently open 
location 

Close the currently open 
location and open the next one 
in sequence 

Close the currently open 
location and open the previous 
one in sequence 

Convert the three specified 
characters into packed Radix 
50 format 



Legal Radix 50 characters for this last response arei 

$ Space 0-9 A-Z 



If any other character is typed, the resulting binary niariber is 

unspecified {that is, no error inessage is printed and the result is 
unpredictable) , Exactly three characters must be typed before ODT 
resumes its normal mode of operation. After the third character is 
typed, the resulting binary number may be stored in the opened 
location by closing the location in any one of the ways listed in 
Table 7-3. For examples 

♦ 1000/ 04g^31 X =KB; CBAJ 
• 1 000/ ail4ai X aCBA 

WABNING 

After ODT has converted the three 
characters to binary, the binary number 
can be interpreted in one of many 
different ways depending on the coinmand 
which follows. For example t 

» 1234/ 063337 X =PRO Xl T/ BBABBA 

Since the Radix 50 equivalent of XIT is 
113574, the final slash in the example 
causes ODT to oj^n location 113574 and 
type out its contents if it is a legal 
address. (itefer to Actions 7,4 and 7,5 
for a discussion of cimmand legality and 
detection of errors, 3 
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7.3.6 Breakpoints 

The breakpoint feature allows the user to monitor the progress of 
program execution. A breakpoint may be set at any instruction which 
is not referenced by the program for data. When a breakpoint is set, 
ODT replaces the contents of the breakpoint location with a trap 
instruction so that program execution is suspended when the breakpoint 
is encountered. The original contents of the breakpoint location are 
then restored and ODT regains control. 



As mainy as eight breakpoints numbered through 7 can be set at any 
one time. A breakpoint is set by typing the address of the desired 
location of the breakpoint followed by ;B, Thus n;B will set the next 
available breakpoint (from 0-7) at address n. Specific breakpoints 
may be set or changed by the n;inB command where m is the number of the 
breakpoint. For example: 



* 1020JB 
« 1 030J B 

* 104018 
«I032J IB 

♦ 



(set breakpoint at address 1020) 

(set breakpoint 1 at address 1030) 

(set breakpoint 2 at address 1040) 

{reset breakpoint 1 at address 1032) 



The ;B comnand without an argument removes all breakpoints. The ;mB 
command is used to remove only one of the breakpoints, where m is the 
number of the breakpoint. For example: 



f i2B 

* 



(remove breakpoint 2) 



A table of breakpoints is kept by ODT and may be accessed by the user. 
The $B/ command opens the location containing the address of 
breakpoint 0. The next seven locations {represented as nnnnnn) 
contain the addresses of the other breakpoints in order, and can be 
sequentially opened by using the LINE FRED key. For example: 

♦SB/001020i 
nnnnnn /00l03g | 
nnnnnn /( addres s internal to ODT) 

In this example breakpoint 2 is not set. The contents printed by ODT 
represents an internal address and can be determined by checking the 
Linker Load Map {see Chapter 6) , 



7.3.7 Running the Program 

Progreun execution is under control of ODT. There are two commands for 
running the program: n;G and n;P. The n;G command is used to start 
execution (Go) and n;P to continue execution (Proceed) after halting 
at a breakpoint. For example: 

^1000JG 

This causes execution to start at location 1000- The program will jrun 
until a breakpoint is encountered or until program completion. If the 
program enters an infinite loop, it must be either restarted or 
reentered as explained in Section 7.4.2. 
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Upon execution of either the n;G or n;P command, the general registers 
0-G are set to the values in the locations specified as §0-$6 and the 
processor Status Register is set to the value in the location 
specified as $S. 

When a breakpoint is encountered, execution stops and QDT prints Bn; 
(where n represents the breakpoint nuFiher) followed by the address of 

the breakpoint. Locations can then be examined for expected data. 
For examples 

*tE))0i3B (breakppint 3 is set at location 10 10 J 

♦li00lG {execution is started at location 1000) 

831 00 1 a 10 (execution is stopped at location 1010) 

* 

To continue progi:»s execution from the breakpoint, type rP in response 
to om's last C*) . 

When a breakpoint is set in a loop, it may be desirable to allow the 
prograra to execute a certain number of tirnes through the loop before 
recognizing the breakpoint. This is done by setting a proceed count 
using the mP command. This command allows the user to specify the 
number of times the breakpoint is to be encountered before program 
execution is isuspended (execution will be suspended on tbe nth 
encounter) . The count, n, refers only to the nui>!bered breakpoint 
which most recently occurred, A different proceed count raay be 
specified for the breakpoint when it is encountered. For example: 

B3^ 001010 (execution halted at breakpoint 3) 
11250IB (reset breakpoint 3 at location 1250} 
*4>P (set proceed count to 4 and continue 

B3> 001850 execution; loop through breakpoint 
* three times and halt on fourth 

occurrence of the breakpoint) 

Proceed counts for other breakpoints may be reset by accessing the 

table of proceed counts, explained next. 

Following the table of breakpoints (as explained in Section 7.3.6) is 
a table of the proceed command repeat counts for each breakpoint. 
These repeat counts can be inspected by typing $B/ followed by typing 
nine LINE FEED's. The repeat count for breakpoint is printed (the 
first seven line feeds cause the ta}>le of breakpoints to be printed i 
the eighth ty[:«s the Single-instruction mode, explained in the next 
section, and the ninth line feed begins the table of proceed command 
repeat counts) , The repeat counts for breakpoints 1 through 7 and the 
repeat count for the single instruction trap follow in sequence (see 
Section 7,3,8), Before a proceed count is assigned a value by the 
user, it is set to Of after the count has been executed, it is set to 
-1. Opening any one of these locations provides an alternate way of 
changing the count, as the location, once open, can have its contents 
modified in the usual manner (by typing the new contents and then the 
RETURJJ key) , For example : 
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nnnnnn/0 01036 | 
nnnnnn/nnnnnn \ 
nnnnnn/0000gg tS \ 

nnnnnn/000ffffff j 



(address of breakpoint 7) 
(single instruction address) 
(count for breakpoint is 
changed to 15) 
(count for breakpoint 1) 



nnnnnn/000000. A , (count for breakpoint 7) 
nnnnnn /nnnnnn._ (repeat count for single 

instruction mode. The 
single instruction address 
will be an address internal 
to the user progran if 
single instruction mode 
is used.) 

The address indicated as the single-instruction address and the repeat 
count for single instruction mode are explained next. 



7.3.8 Single-Instruction Mode 

Using this mode the prograinmer can specify the number of instructions 
to be executed before suspension of the program run. The Proceed 
command, instead of specifying a repeat count for a breakpoint 
encounter, specifies the number of succeeding instructions to be 
executed. Breakpoints are disabled when single-instruction mode is 
operative. 

Commands for single-instruction mode are: 



;nS 



n;P 



?S 



Enable single-instruction mode (n can 
have any value and serves only to 
distinguish this fom from the form ;S) . 
Breakpoints are disabled. 

Proceed with progran run for next n 
instructions before reentering ODT <if n 
is missing, it is assumed to be 1, Trap 
instructions and associated hemdlers can 
affect the Proceed repeat count. See 
section 7.4.2) , 

Disable single-instruction mode. 



When the repeat count for single-instruction mode is exhausted and the 
program suspends execution, ODT prints; 

B8;n 

* 

where n is the address of the next instruction to be executed. The $B 
breakpoint table contains this address following that of breakpoint 7. 
However, unlike the table entries for breakpoints 0-7, direct 
modification has no effect. 
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Sirailarly, following the repeat (proceed) count for breakpoint 7 is 
the repeat count for single- instruction mode. This table entry may foe 
directly modified, and thus is an alternative way of setting the 
single-instruction mode repeat count. In such a cage, jP implies the 
argument set in the $B repeat count table rather than assuming 1, 



7.3.9 Searches 

With ODT all or any specified portion of tneanory can be searched for 
specific bit pattern or for references to a sfKcific location. 



Word Search, n;W 

Before initiating a word search, the mask and search limits must be 
specified. The location represented by $M is used to specify the mask 
of the search. $M/ opens the mask register. The next two sequential 
locati<Mis {opened by line feeds! contain the lemer and upper limits of 
the search. Bits set to 1 in the irtask are examined during the search? 
other bits are ignored. Then the search object atnd the initiating 
coram»id are given using the njtW command where n is the search object. 
When a match is found {i.e., each bit set to 1 in the search object is 
set to 1 in the word being searched over the mask range) , the matching 
word is printed. For example: 

jjM^000000_17 7 400i (test high-order eight bits) 

nnnnnn /0gg000 1 000V (get low address litrtit) 

nnnnnn /0&mm 1 043 J (get high address limit) 

*400JW (initiate word search) 
301010 /0a0770 
001034 /0B04^4 



In the above exaii^le, nnnnnn Is an address internal to ODT; this 
location varies and is meaningful only for reference purposes. In the 
first line above, the slash was used to open $M which now contains 
177400? the line feeds opened the next two sequential locations which 
now contain the upper and lower limits of the search. 

In the search process an exclusive OR (XOR) is performed with the word 
currently being examined and the search object, and the result is 
ANDed to the mask. If this result is zero, a match has been found and 
is reported on the terminal. Note that if the mask is zero^ all 
locations within the limits are printed. 

Typing CTlL/u during a search printout terminates the search. 



Effective Address Search, r;E 

ODT provides a command to search for words which address a specified 

location. The mask register is opened only to gain access to the lew 
and high limit registers. After specifying the search limits (as 
explained previously) , the command njE is typed (where n is the 
effective address) and the search is initiated. 
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words which are either an absolute address (argument n itself | , a 
relative address offset, or a relative branch to the effective 
address , are printed after their addresses . For example : 



riinnnnn//00 1 000 
nnnnnn//00 1 0'*0 
♦ 1034J E 
001016 /00l0g6 
001054 /00a767 

*i0gaiE 

001088 /177774 
001030 /001020 



]0l0i 
1060 J> 



(open mask register only to gain 
access to search limits) 

(initiatincj search) 
(relative branch) 
(relative branch) 
(initiating a new search) 
(relative address offset) 
(al>solute address) 



Particular attention should be given to the reported references to the 
effective address » since a word may have the specified bit pattern of 
an effective address without actually being so used. ODT reports all 
possible references whether Uiey are actually used as such or not. 

Typing CTKL/U during a search printout teminates the search. 



7,3.10 The Constant Kegister 

It is often desirable to convert a relocatable address into its value 
after relocation or to convert a number into its taro^s complement? and 
then to store the converted value in one or more places in a pr»jram. 
The Constant Register provides a means of accomplishing this and other 
useful functions. 

when n;C is typed, the relocatable expression n is evaluated to its 
six-digit octal value and is both printed on the terminal and stored 
in the Constant Register. The contents of the Constant Register may 
be called in subsequent relocatable expressions by typing the letter 

c. Examples are: 



«-i4432l C » 173346 

♦ 1000/'001000_C 

♦ 10001 IR 

mr 

♦ 

♦ t, 42721 Cf005272 
i 



(The two's complement of 4432 is 

placed in the Constant Itegister) 

(The contents of the Constant 

Register are stored in location 1000) 

(Relocation register 1 Is set to 
1000) 

(Relative location 4272 is reprinted 
as an absolute location and stored 
in the Constant Itegister) 



7,3,11 teraory Block Initialization 

The Constant Tlegister can be used in conjunction i^ith the ctawianda ;F 
and fl to set a block of memory to a given value. While the most 
common value required is zero, other possibilities are plus one, minus 
one, ASCII space, etc. 
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When the command jP is typed, ODT stores the contents of the Constant 
Register in successive JiKinory words starting at the memory word 
address specified in the lower search limit and ending with the 
address specified in the upper search linit. 

WJien the command ;I is typed, the low-order 8 bits in the Constant 
Register are stored in successive bytes of memory starting at the byte 
address specified in the lower search lirxit and ending with the byte 
address specified in the upper search limit. 

For example, assume relocation register 1 contains 1000, 2 contains 
2000, and 3 contains 3000, The following sequence sets word locations 
1000-1776 to zero, and byte locations 2000-^777 to ASCII spaces. 



♦SM/ 000000 i 

nnnnnn/ 800000 '*g^ 
nnnnnn /00Bg0g a* -^J 
«0lC » 000000 

* J F 

*$M/000000.i , 

nnnnnn/00177 6 3j - 1 J) 

»40lC -g00B40 



(Open nask register to gain 
access to search limits) 
(Set lower limit to 1000) 
(Set upper limit to 1776} 
(Constant Register set to zero) 
(Locations 1000-1776 set to zero) 



(Set lower limit to 2000) 
(Set upper linit to 2777) 
(Constant aegister set to 40-~ 

ASCII space) 
(Byte locations 2000--2777 are set 

to value in low-order 8 bits of 

Constant FSegister) 



1.3,12 Calculating Offsets 

Relative addressing and branching involve the use of an offset--the 
number of words or bytes forward or backward from the current location 
to the effective address. During the debugging session it may be 
necessary to change a relative address or branch reference by 
replacing one instruction offset with another, ODf calculates the 
offsets in response to the njO conmand. 

The coimmand njO causes ODT to print the 16-bit and 8-hit offsets frcm 
the currently open location to address n. For examples 

*3A6/mm2A_4lAfO 00004^ 022 ggj 

In the example, location 346 is opened and the offsets from that 
location to location 414 are calculated and printed. The contents of 
location 346 are then changed to 22 (the 8-bit offset) and verified on 

The 8-bit offset is printed only if it is in the range 128 {decimal) 

to 127 (decimal) and the IG-bit offset is even, as was the case above. 

For example, the offset of a relative branch is calculated and 

modified as follows: 

♦ 1034/ 103421 \Q)2AtQ 177776 377 \0gl * 377 J 
»/ 103777 
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Note that the jfiofiified lov-order byte 377 must be coptbined with the 
unmodified high-order byte. 



7,3,13 Relocation ftegister Corrmands 

The ase of the relocation registers has been defined in Section 7.2. 
At the beginning of a debugging session it is desirable to preset the 
registers to the relocation biases of those relocatable modules which 
will be receiving the most attention. 

This can be done by typing the relocation bias followed by a semicolon 
and the specification of relocation registers, as follov'ss 

rinR 

r may be any relocatable expression and n is an Integer from to 7. 
If n is omitted it is assumed to be . As an example; 

*1000J5R {Set relocation register 5 to lOOQ) 
*5j100iSR {Add 100 to the contents of 
* relocation register 5) 

In certain uses programs may be relocated to an address below that at 
which they were asseii&rled. This could occur with PIC coding which is 
moved without the use of the Linker, In this case the appropriate 
relocation bias would be the 2's complement of the actual downward 
displacement. One methcd for easily evaluating the bias and entering 
it in the relocation register is illustrated in the following example, 

AssiMSK the program was assembled at location 5000 and was moved to 
location 1000, Then the sequence j 

*l*-5000i III 

* 

enters the 2's complement of 4000 in relocation register 1, as 
desired. 

Relocation registers are initialized to -1, so that unwanted 
relocation registers never enter into the selection process when OOT 
searches for the most appropriate register. 

To set a relocation register to -1, type jnR. To set all relocation 
registers to -1, type ;R. 

ODT maintains a table of relocation registers, beginning at the 
address specified by $R, Opening $R ($R/) opens relocation register 
0, Successively typing the LINE FEED key opens the other relocation 
registers in sequence. When a relocation register is opened in this 
way, it may be modified just as any other it^mory location. 
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7.3,14 The Relocation Calculators 

When a location has been opened, it is often desirable to relate the 
relocated address and the contents of the location back to their 
relocatable values. To calculate the relocatable address of the 
opened location relative to a particular relocation bias, type nl, 
where n specifies the relocation register. This calculator works with 
both opened bytes and words. If n is omitted, the relocation register 
whose contents are closest but less than or equal to the opened 
location is selected automatically by ODT. In the following example, 
assume that these conditions are fulfilled hy relocation register 2, 
which contains 2000. To find the most likely module that a given 
opened byte is in, the user types: 

♦g5B0\ 01 I » ! «a, 000500 

Typing nR after opening a word causes odt to print the octal number 
which equals the value of the contents of the opened location minus 
the contents of relocation register n. If n is omitted, ODT selects 
the relocation register whose contents are closest but less than or 
equal to the contents of the opened location. For example, assume the 
relocation bias stored in relocation register 1 is 001234? then: 

» 1 , 500/02£550_l R «I, 023314 

The value 23314 is the contents of 1,500, relative to tlie base 1234, 
An example of the use of both commands follows. 

Assuming relocation register 1 contains 1000 and relocation register 2 
contains 2000, then to calculate the relocatable address of location 
30 00 and its contents relative to 1000 and 2000, the following can be 
performed: 

#3000/005670 lis 1,002000 21 = 2,001000 1R»1, 004670 aR-e^003 67 



7,3.15 ODT's Priority Level 

$P represents a location in ODT which conta5,ns the priority level at 
which ODT operates. If SP contains the value 377, OKT operates at the 
priority level of the processor at the tine ODT is entered. Otherwise 
SP inay contain a value between and 7 corresponding to the fixed 
priority at which ODT will operate. 

To set ODT to the desired priority level, open SP. ODT prints the 
present contents, which may then be changed! 

*$P/ 000006 37 7 J 

If $P is not specified, its value will be seven. 

Breakpoints may be set in routines at different priority levels. For 
example, a program running at a low priority level may use a device 
service routine which operates at a higher priority level. If a 
breakpoint occurs from a low priority routine, if ODT operates at a 
low priority, and if an interrupt occurs from a high priority routine, 
then, the breakpoints in the high priority routine will not be executed 
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since they haire been remtiveci when the low priority breakpoint 
occurred. That is, interrupts set at a priority higher than the one 
in which ODT Is running will occur and any breakpoints will not be 
recogniaed. 

For exstnple: 

*]000lB 
«2000lB 
*500IG 
BgJ 1000 

£ 

If a higher level interrupt occurs while ODT ia waiting for input, the 
interrupt will be serviced and no breakpoints will be recognized. 

NOTE 

If the user is debugging a program which 
utilizes double-buffered cassette I/O 
Ceapecially in formatted modes) , he may 
find it useful to set OUT' s priority to 
5, This will allow cassette flags to 
interrupt OUT but will lock out terminal 
printer, keyboard, and line printer 
interrupts. If this is not done and a 
breeikpoint is encountered while cassette 
I/O is occurring, timing errors will 
occur* 



7.3.16 ASCII Input and Output 

ASCII text may be inspected and changed using the command t 

r;nA 

where r is a relocatable expression and n is a character count. If n 
is omitted it is assumed to be 1, ODT prints n characters starting at 
location r, followed by a carriage return/line feed. One of the 
following »ay then be typed: 



RETUI^ 



ODT outputs a carriage return/line 
feed and an asterisk and waits for 
another coiwmand. 



LINE PEED 



ODT opens the byte 
last byte output. 



following the 



up to n 

charac— 
Xf& rs o i 

text 



ODT inserts the text into E^mory 
starting at location r. If less 
than n characters are typed, ter- 
minate the comm^id by typing 
CTRL/U, causing a carriage 
return /line feed and an asterisk to 
be output as for RETURN, However, 
if exactly n characters are typed, 
ODT responds with a carriage 



7-19 






return/line feed, the address of 
the next available byte and a 
carriage return/line feed/asterisk. 

Note that n may actually be expressed as a relocatable expression and 
could accidently be quite large. There is no safeguard against this 

in OiJT. 



7.4 PROGRAWMING CONSIDERATIONS 

Information in this section is not necessary for the efficient use of 
ODT, However, it does provide a better understanding of how ODT 
performs gone of its functions ; in certain difficult debugging 
situations, this understanding is necessary. 



7.4,1 Functional Organization 

The internal organization of ODT is alnost totally modularized into 
independent subroutines. The internal structure consists of three 
major functions: command deccKling, coinmand execution, and various 
utility routines. 

The command decoder interprets the individual ccaranandB, checks for 
cc»jmand errors, saves input parameters for use in command execution, 
and sends control to the appropriate command execution routine, 

!Ehe command execution routines take parameters saved by the command 
decoder and uses the utility routines to execute the specified 
command. Command execution routines exit either to the object program 
or back to the command decoder. 

1?he utility routines are common routines such as SAVE- RESTORE and I/O, 
They are used by both the connand decoder and the comip.and executers. 



7.4,2 Breakpoints 

The function of a breakpoint is to git^e control to ODT whenever the 
user program tries to execute the instruction at the selected address. 
Upon encountering a breakpoint, all of the ODT commands can be used to 
examine and modify the program. 

When a breakpoint is executed, ODT removes all breakpoint instructions 
from the user's code so that the locations may be exj^nined and/or 

altered. ODT then types a message on the console terminal in the form 
am;n where n is the breakpoint address (and ra is the breakpoint 
number) , The breakpoints are automatically restored when execution is 
resumed. 

One restriction in the use of breakpoints follows t the word where a 
breakpoint has been set must not be referenced by the program in any 
way since ODT has altered the word. Also, no breakpoint should be get 
at the location of any instruction that clears the T-bit. For 
example I 

MOV #240,177776 j SET PRIORITY TO LEMEL 5 
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NOTE 

Instructions that cause or return from 
trapa (e.g., Er-IT, RTIJ are likely to 
clear the T-hit, since a new word from 
the trap vector or the stack will be 
loaded into the Status Register. 

h breakpoint occurs when a trace trap instruction (placed in the user 

program by ODT> is eKecuted. When a breakpoint occurs, the following 
steps are tatens 

1, Set processor priority to seven (automatically set by 
trap instruction) . 

2. Save registers and set up stack. 

J, If internal T-bit trap flag Is set, go to step 13. 

4. Remove breakpoints. 

5. Reset processor priority to ODT's priority or user's 
priority. 

6. Make sure a breakpoint or single-instruction wode caused 
the interrupt. 

7. If the breakpoint did not cause the interrupt, go to 

step 15. 

8. Decrement repeat count. 

9. Go to step 18 if non-zero; otherwise reset count to one, 

10. save console terminal status (refer to the section 
entitled 'Procedure for Saving and Restoring Console 
Terminal Status* below), 

11. Type PBsaage about the breakpoint or single-instruction 
mode interrupt. 

12. Go to cormmand decoder, 

13. Clear T-bit in stack and internal TN-bit flag, 

14. Juiap to the Go processor. 

15. Save console terminal status, 

16. Type BE (Bad Entry) followed by the address, 

17. Clear the T-bit, if set, in the user status and proceed 
to the command decoder. 

18. Go to the Proceed processor, bypai^sing the console 
terminal restore routine. 
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Not* that steps 1-5 inclusive take approximately 100 microseconds 
during which tine interrupts are not permitted to occur (ODT is 
running at level 7) . 

When a proceed (;P) cornmand is given, the following occurs j 

1, The proceed is checked for legality, 

2, The processor priority is set to seven. 

3, The T-bit flaga (internal and user status) are set, 

4, The user registers, status, and Program Counter are 

restored. 

5- Control is returned to the user. 

6. When the T-bit trap occurs, steps 1, 2, 3, 13, and 14 of 
the breakpoint sequence are executed, breakpoints are 
restored, and program execution resumes normally. 

When a breakpoint is placed on an lOT, EMT, trap, or any instruction 
causing a trap, the following occurs: 

1. When the breakpoint occurs as described above, OUS is 
entered, 

2. When ;P is typed, the T-bit is set and an lOT, EMT, 
TRAP, or other trapping instruction is executed. 

3. This causes the current PC and status (with the T-bit 
included) to be pushed on the stacks 

4. The new PC and status (no T-bit set) are obtained from 
the respective trap vector. 

5. The whole trap service routine Is executed without any 
breakpoints, 

6. When an RTI is executed, the saved PC and PS (including 
the T-bit) are restored. The instruction following the 
trap-causing instruction is executed. If this 

instruction is not another trap-causing instruction, the 
T-bit trap occurs, causing the breakpoints to be 
reinserted in the user program, or the 
single-instruction mode repeat count to be decremented. 
If the following instruction is a trap-causing 
instruction, this sequence is repeated starting at step 
3. 

NOTE 

Exit from tJte trap handler must be via 
the RTI instruction, otherwise the T-bit 
is lost. ODT cannot gain control again 
since the breakpoints have not yet been 

reinserted- 
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Note that the ;P coimnand is illegal if a breakpoint has not occurred 
CODT responds with ?) ; ;P is legal, however, after any trace trap 

entry. 

The internal breakpoint status words have the following format: 

1. The first eight words contain the breakpoint addresses 
for breakpoints 0-7, {The ninth word contains the 
address of the next instruction to be executed in 
single-instruction mode.) 

2. The next eight words contain the respective repeat 
counts . The following word contains the repeat count 
for single-instruction mode.) 

These words may be changed at will, either by using the breakpoint 
commands or by direct manipulation with $B. 

When program runaway occurs (that is, when the program is no longer 
under ODT control, perhaps executing an unexpected part of the program 
where a breakpoint has not been placed} ODT may be given control as 

follows) 

1. Press the HALT key to stop the computer. 

2. If ODT was linked with the user's program, start OIW at 
any one of these addresses : 

a} Its entry address {contents of locations where 
breakpoints were set are not restored to their 
original contents). 

b} Its entry address + 2 (contents of locations where 
breakpoints were set are restored; all breakpoints 
are removed and all relocation registers are 

c| Its entry address + 4 jsiraulates a breakpoint) , 

3. If ODT was not linked with the user's program, but the 
user executed a lOAD/G ODT or a ,R ODT, the entry 
address of ODT in an 8K system is 14000. One of the 
restart addresses in 2 above may then be used. 

O0T prints an (*) indicating that it is ready to accept a command. 

If the program being debugged uses the teleprinter for input or 
output, the prograri may interact with ODT to cause an error since ODT 
uses the teleprinter as well. This interactive error will not occur 
when the program being debugged is run without ODT. 

1. If the teleprinter interrupt is enabled upon entry to 
the ODT break routine and no output interrupt is pending 
when ODT is entered, ODT generates an unexpected 
interrupt when returning control to the program. 
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2. If the interrupt of the teleprinter reader (the 
keyboards is enabled upon entry to the ODT break routine 
and tlie program is expecting to receive an interrupt to 
input a character, both the expected interrupt and the 
character are lost. 

3. If the teleprinter reader (keyboard) has just read a 
character into the reader data buffer when the ODT break 
routine is entered, the expected character in the reader 
data buffer is lost. 



Procedure for Saving and Restoring 

Console Teinminal Status 

Upon entering the console terminal SAVE routine, the following occurs; 

1. Save the console terminal keyboard status register 
(TKS) . 

2. Clear Interrupt enable and maintenance bits in the TKS, 

3. Save the console terminal printer status register (TPS) . 

4. Clear interrupt enable and maintenance bits in the TPS, 
To restore the console terminal status j 

1. Wait for conpletion of any I/O from ODT. 

2. Restore the TKS. 

3. Restore the TPS. 

WARNINGS 

If the console terminal printer 

interrupt is enal^led upon entry to the 

ODT break routine , the following may 
occur; 

1. If no output interrupt is 
pending when ODT is entered, an 
additional interrupt always 
occurs when OiDT returns control 

to the ufser. 

2, If an output interrupt is 
pending upon entry, the 
expected interrupt occurs when 
the user regains control. 

If the teleprinter keyboard is busy or 
done , the expected character in the 

reader data buffer is lost. 

If the teleprinter keyboard interrupt is 
enabled upon entry to the ODT break 
routine, and a character is pending, the 

interrupt (as well as the character) is 
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7,4*3 Searches 

The word search allows the user to search for bit pattarna in 
specified sections of memory. Using the $M/ coFimand, the user 
specifies a mask, a lower search limit ^$M+2) , and an upper search 
limit ($M+4). The search object is specified in the search command 

The word search compares selected bits (where ones appear in the mask) 
in the word and search object. If all of the selected bits ai» equal, 
the unmasked word is printed. 

The search algorithja isj 

1. Fetch a word at the current address* 

2. XOR {exclusive OR) the word and search object. 

3. AND the result of step 2 with the mask. 

4. If the result of step 3 is zero, type the address of the 
unmasked word and its contents. Otherwise, proceed to 
step 5. 

5. Add two to the current address. If the current address 
is greater than the upper limit , type * and return to 
the command decoder, otherwise go to step 1. 

Note that if the mask is aero, ODT prints every word between the 
limits, since a match occurs every time (i.e., the result of step 3 is 
always zero) . 

In the effective address search, ODT interprets every word in the 
search range as an instruction which is interrogated for a possible 
direct relationship to the search object. The mask register is opened 
only to gain access to the search liiftit registers. 

The algorithm for the effective address search (where X denotes the 
contents of X, and K denotes the search object) is: 

1, Fetch a word at the current address X, 

2, If (X)=K [direct reference) , print contents and go to 
step 5. 

3, If (X) +X+2=K [indexed by PC], print contents and go to 

step 5 . 

4, If (X) is a relative branch to K, print contents. 

5, Add two to the current address. If the current address 
is greater than the upper limit, perform a carriage 
return/line feed «md return to the command decoder; 
otherwise, go to step 1, 
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7,5 ERROR DETECTION 

ODT detects two types of error: illegal or unrecognizable coininand and 
bad breakpoint entry. ODT does not check for the legality of an 
address when commanded to open a location for exarnination or 
modification. Thus the command: 

177774/ 

references nonexistent memory, thereby causing a trap through the 
vector at location 4. RESMON sets location 4 to produce the message: 

%TRAP nnnnnn 

However, if the user program modifies location 4 or 6, the results of 
such a trap are unpredictable. 

Similarly, a command such as: 

S20/ 

which references an address eight times the value represented by $2 , 
may cause cin illegal (nonexistent) memory reference. 

Typing something other than a legal command causes ODT to ignore the 
coramcind, print: 

(echoes illegal command) ? 

and wait for another command. Therefore, to cause ODT to ignore a 
command just typed, type any illegal character (such as 9 or RUBOUT) 
and the command will be treated as an error and ignored. 

ODT suspends program execution whenever it encounters a breakpoint by 
trapping to its breakpoint routine. If the breakpoint routine is 
entered and no known breakpoint caused the entry, ODT prints: 

BEe0154g 

and waits for another command. In the example above, BE001542 denotes 
Bad Entry from location 001542. A bad entry may be caused by an 
illegal trace trap instruction, setting the T-bit in the status 
register, or by a jump to the middle of ODT. 



7.6 EXAMPLE USING ODT 

The user has a progreun which he has assembled with PAL to produce a 
listing. He wishes to run the program under ODT to demonstrate the 
use of brsciXpoints i 
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CAPSIl PAL V0! 05/25/73 PAGE 



001 



IPRCX5RAM TO DEHmSTRATE ODT 
I 





000001 


Rl-Sl 








000002 


R2«S2 








000000 


R0»X0 








000003 


R3=X3 








000006 


SP-S6 








000000 


. ASEGT 








001000 


.=1000 






001000 


012706 

000600 


STARTS 


Moy 


#600^ S 


001004 


012703 
060008 




MOV 


#2*R3 


001010 


0127 00 
000200 


L00P24 


MOV 


»&@Bj> R 


001014 


005801 




CLR 


Rl 


001016 


00S201 


LOOPl! 


INC 


RJ 


001020 


005300 




DEC 


R8 


001022 


001375 




m£ 


LOOPl 


001024 


005302 




DEC 


R2 


001026 


001370 




BNE 


LOOPS 


001030 


800000 




H(!^T 






001000 




.END 


START 


CAPSIl PAL V0l 05/25/73 PAGE 


002 


LOOPl 


001011 


t 


L00P2 


001010 


Rl SX000001 




R2 


>Z000002 


SP =X00000£ 




START 


001000 



#2*R3 J SET LARGE LOOP COUNTER 



JINCREMIWT Rl FR0?1 TO 200 
I DECREMENT R0 FROM 200 TO 
INOT DONE SHALL LOOP YET 
i RESTART SMALL LOOP 
JIF R3 NOT ZERO YET 



R0 


'Z000000 


R3 


« 3000003 


P 


= 00103S 



000000 ERRORS 

The program is stored on cassette drive 1 as TESODT.LDA, and is loaded 
into meniory using the LOAD comptand; 



• L UTESODT.LDA 

oar is then called. The debugging process follows (NNNNNH 
an address internal to OOT) , 



represents 






ODT V00 
IBa2j0B 
1 024J B 
rl>SB/00t022 
NNNNNN /0 01 02 4 
i i NNNNHN /I 17776 
NKNNNN /I 1777 6 
• *1000J<3 
.B0I 001022 
*$6/000600 
*t3/000002 
J*il 
*^ 1*S0/0@017? 
%S1/00000I 
* $8/001022 
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G < 



NNtnSNN /00|iaS4 
*100JP 
B0* 001022 
4>S3/000002 
D <*S0/00007 7 
«St/@00l01 
*SB/001022 
miNHNN /001024 

'*76JIP 
601001022 
E {♦$3/000002 
*S!/000177 
« £0/000001 
*IP 

B0; 001022 
•S0/000000 

•si/g00a0i 

*S3/00e002 

♦ 1024/005302 5303 

f#i P 
BU 001024 
♦$3/000002 
♦S8/0010S2 
NNNNNN /001024 

♦ 1026JB 
•$B/0010g2 
NNNHNN /a 01 024 
NNNNNN /00I026 
KKNWNN /im76 
«SS/000@04 

♦ IP 

SSI 001026 
♦53/000001 
♦SS/000000 
• $0/000000 

.♦Sl/000200 

♦ IP 

801001022 
♦$0/000177 
♦$1/000001 
•S3/B00001 
♦2001 P 
BU 001024 
♦$0/000000 

♦ £1/000200 
•$3/000001 
♦55/000004 

r*ip 

B2I0010S6 
L ^♦$3/000004 
♦53/000000 

♦ 10301 B 

♦ IP 
B3I 001030 

♦ fC 



M' 



I* 
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A Set breakpoint within the small loop; aet the next 
available breakpoint (1) within the large loop, 

B Examine ODTT's breakpoint table ~ and 1 are properly 
assigned? start the prograjn, 

C Breakpoint is encoimteredi registers 3 and 6 are examined. 
An illegal conmand (#) is typed, which OOT ans%iers with a ?. 
Registers and I and the ODT breakpoint table are examined, 

D Proceed through 100 (octal) occurrences of breakpoint 0; 
examine the registers— 3 is unchanged, and I are 
decreraentinq and incrementing properly, 

E Proceed through 76 more occurrences of breakpoint Q; the 
registers are exanined and seem correct. 

F Proceed from breakpoint 0. The small loop has finished, but 
the instruction at location 1024 is incorrect ^t shculd be 
DEC R3) ; it is corrected. 

G Execution proceeds; breakpoint 1 is encountered 

H The next available breakpoint (which is breakpoint 2) is set 
as location 1026, the user status Z bit has been set, 

I Breakpoint 2 is encountered; register 3 has been decrenented? 
the Z bit is clear so the branch to loop 2 will be taken. 

J Breakpoint is encountered; registers and 1 have been 
reset, 

K Continue through all iterations of the small loop. 
Breakpoint 1 is encountered. Agister 3 contains 1} the user 
status Z bit is set. 

L Breakpoint 2 is encountered; the Z bit is still set and 
register 3 contains 0; program execution will fall through 
the branch. A breakpoint is set at the IIMJT instruction, 

M The breakpoint at the HALT is encoimtered. A fC is typed to 
return to the Keyboard Monitor, 
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PERIPHERAL INTERCHANGE PHDGHAM 



The Peripheral Interchange Program (PIP) provides the user with a 
means of transfering files between any of the permanent devices which 
are available on his system (as listed in Table 3-2) including the 
high-speed reader and punch, in addition, PIP provides the capibility 
for deleting files from a cassette, zeroing a cassette, and making 
multiple copies of a cassette. 



B,l CALLING iaiD USING PIP 

PIP is called from the System Cassette by typings 

^R PIP 

in response to the dot printed by the Keyboard Listewner, The Comtiand 
String Interpreter responds by printing an asterisk (*) when it is 
ready to accept input/output specifications. The user may enter his 
coinmand string even though the remainder of PIP is being loaded into 
memory simultaneously. 

Control is returned to PIP after each execution of am I/O command 

string. 



8,1.1 PIP Options 

The options listed in Table 8-1 may be used by PIP with the following 
results : 



3-1 



Table 8-1 
PIP Options 



Option 


leaning 


/A 


Used with an output filename to designate 
that the header bit be set to ASCII <the file 
type is otherwise asswrteed to be binary) , If 
a file is trans fered from the paper tape 
reader to cassette using the /A option, a ^Z 
character (designating end-of-file) is 
automatically appended to the end of the 
file. 


/c 


Allows the comnand string to be broken into 
one or more lines. 


/D 


Causes the filenar«e{s) indicated in the 

comnand line to be deleted £ron the specified 

cassette. 


/P 


Requests that the syst*^i prompt the user to 
change cassettes on the indicated drive 
before an attempt is made to access the file, 

ttie aystera prints: 




17 


K 


where # represents the number of the 
appropriate drive. When the user has mounted 

the proper cassette, he may type any 
character on the keyboard to continue 
execution. 


/a 


Indicates that all cassettes on the unit 
drives specified in the cc^mnand line are to 

be meroed. 



PIP does not support the /O overflow option, 

exceed a single cassette. 



.le transfers must not 



8,1.2 Input and Output Specifications 

PIP allows four basic operations: cassette zero, file deletion, 
cassette copy, and file transfer. No default extensions are assumed 
by PIP, so the user must be sure to always indicate extensions in his 
command line. 



CftSSET^TE ZEH> 

The cassette zero function is provided in PIP to allow a user who is 
performing a series of PIP commands the option of zeroing a cassette 
without returning to the Keyboard Monitor (to use the gEBO command). 
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The form of the coramand is: 

•[CT]#!/2/0PT,. .. tCT]#:/OPTl=] 

The device, if specified, must be cassette, so only the drive nunAter 
need be entered; unit is assumed if no number is indicated. Miy 
nunber of cassettes may be indicated in the copufiand line? the /S! 
option is necessary only once after the first cassette specification. 
The /C and /p options are optional jr as is the 1/0 separator £«, <, or 
•+-}. The input field must be empty if a separator is used. 

An example of use of the PIP zero function might be the following case 
in which the user wishes to zero several cassettes ? 

* et /Z * 1 i 4 ii /F# 1 1 J, 0: /P* 1 1 ■ 

/Z indicates that the PIP zero function is requested; the cassettes on 
units and 1 are zeroed j the user is then prompted (via /P) to change 
cassettes; he mounts different cassettes on drives and 1 and then 
types any character on the console terminal keyboard to continue 
execution, Thm newly mounted cassettes are also zeroed; again he is 
proinpted to change cassettes, and so on. 



FILE DELETION 

File deletion is performed using a command line in the following forms 

* ICT] # :F1LE1. EXT/OPT, (CT ] # JFILE2 .EXT/OPT, .,.[=] 

Cassette drives and 1 are the only legal devices and drive is the 
default device. Filenames axe indicated only on the output (left) 
portion of the command line? the input portion of the cowiand line 
must remain enpty. Options allowed are /D, /C and /P; the /D option 

is necessary only once after the first file specification, 

Any nuKiber of files may be indicated in the coiwiand string. Those 
files specified are then deleted from the cassette directory and are 
replaced by an *EiMPTY header in the directory listing. If PIP detects 

that the sentinel file iimnediately follews an "EMPTY file, it will 
also delete that "EMPTY file from the directory. For example, assuree 

the directory of cassette drive is s 

21-HAR-7a 

COPSO LOA 01-DEC-TS 
BL^KS DAT 21-NAR-T3 
SORT LST SI-MAR-T3 
TORN ASC I9-WAR-73 

and the user types t 

• iLANKS.DAT/D^TCtfe*. ASC« 

These two files will be deleted leaving the directory as follows! 
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COPSO LDA ei-DEC-7£ 

♦ EMPTV 

SORT LSI 2l»MIAR-7 3 

If more than one file exists on a cassette under the same filename^ 
all files under that name will be deleted. 



CASSETTE COPY 

The PIP copy function is used to "clean up* cassettes containing 
*EMPTY headers and to siake multiple copies of a cassette. The form of 
the command string iss 

*[CT]#i=tCTl#j/OPT 

Sine® cassettes are the only legal devices, only the cassette number 
need be specified; cassette drive is the default device. The only 
option allowed in the copy function is /C and only one input and one 
output device specification way be indicated. For example: 

• CTU«01 

The cassette on drive 1 is first zeroed, and the entire contents of 
cassette drive are then copied to the cassette on drive 1, producing 
an exact copy of cassette 0. Oates are copied as they appear on the 

original cassette, "nhis copy function of PIP is particularly useful 
in making multiple copies of the System Cassette. 



FILE TRANSFER 

h file transfer using PIP is initiated by a cojicnand in one of the 
following formats* 

*DEV:FILEMA.EXT/OPT=DEVjFILEl.EKT/OPT, . . .DEViPIl^En ,BXT/OPT 
or 

*DEV sOUTl. EXT/OPT, . , , DEVtOUTn.EXT/OPT-DEVsINl. EXT/OPT, . . ,/C 

,BEVslHn. EXT/OPT 

DEV represents any of the legal permanent devices (listed in Tatele 
3-2) , Any nunft>er of input specifications are allowed. If only one 
output specification is indicated, all input files will be combined 
under tJie filename and/or device designated in the output field; the 
input files will be cortsined in the order in which they are listed in 
the coramand string. Otherwise, each input file must have a 
corresponding output filename and/or device, and transfers will be 
perfornsd on a one-for-one basis. Options allowed in the output 
portion of the command line are /P, /A, and /C. Options allowed in 
the input portion are /P, /F and /C. 

For example* 

»LP!» It ABC. DAT,8JFIRST.ASC, 1jF1NT.DAT /P 
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A listing is to be output on the line printer. First the file ABCIffiT 
on cassette drive 1 is output, then without interruption FIRST, ASC on 
drive 0, and finally FINT.DAT. Befoi^ PINT. DAT is output, the system 
pauses and prints: 

II 

The user should make sure the correct cassette is mounted on drive 1 
and then type any character on the keyboard. The listing will 
continue, 

After each execution of a PIP cormand string, control returns to PIPf 
the CcKiimand String Interpreter prints an asterisk to indicate that it 
is ready to accept another PIP CQjnmand string. The user might next 
enter a conmand line such as the fol lowing s 

«LPS , 1 J AFT. DAT J, SI QN A. PAL /A-01 AFT. DAT, AFT . DAT* SI 6N A. PAL 

This eomiTwmd transfers the file AFT. DAT to both the line printer and 

cassette drive 1, and then transfers SIGMA. PAL in ASCII mode to 
cassette drive 1, If the nuirtser of input files is not equal to the 
number of output specifications (providing there is more than one 
output specification) , an error message is printed. 

To return to the Monitor, type t-C. 



8.1,3 Restarting PIP 

PIP is automatically restarted after each execution of a coramand line; 
the CSI prints an asterisk indicatng that the user can enter a new 
command. A CTRL/P typed during execution of a cojswnand will cause the 

current output file to be closed and control will be returned to the 



S.2 ERROR MESSACffiS 

The following error messages can occur during incorrect usage of PIP: 

Table 8-2 
PIP Error Messages 



Message 


Meaning 


?BAD TAPE 
?BAD TAPE? 


Hardware checksum error (may also be 
caused by READ operations initiated on 
a cassette which is positioned after 
the sentinel file) j a question mark 
following the message indicates that 
the error is not fatal ^ the user may 
mount another cassette and type any 
character on the keyboard to continue 
execution. 



CContinu^ on next page) 
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Table 8-2 (Cont.) 
PIP Error Messages 



Message 



Meaning 



?EOM 



7EXCBSS INPtfT FILES 



7EXCESS OUTPUT FILES 



?F1LE NOT FND? 



7ILLBGAX, DEVICE 



? ILLEGAL INPUT LIST 



O01!'PUT IjXST 



?r/0 CHAN CONPLICT 



?N0 FILE NAME 



?OFPLINB X 



?SWITCH ERROR 'x'? 



Indicates an out-of -paper condition 
for the line printer, console 
terrninalf or paper tape punch. 

The nur^^er of input files exceeds the 
number of output files {providing the 
number of output files is greater than 
one) ; this error occurs during use of 
the file transfer function. 

The nunber of output files exceeds the 
number of input files? this error 
occurs during use of the file transfer 
function. 

The specified file was not found on 
the cassette indicated r the user may 
mount another cassette and type any 
character on the keyboard to continue 
the search , 



pjx illegal device was 
the PIP function used. 



indicated for 



An input list was indicated where not 
allowed (as when using the zero, 
delete, and copy functions), or an 
illegal command was entered. 

An output list was indicated where not 
allowed (as when using the copy 
function) . 

An attempt was made to open an input 
file on a c asset ta already open for 
output, or vice versa. 

A filename was not indicated in a 
ccmrraand line which required one. 

The cassette is not properly mounted 
on drive x. The user should correctly 
mount the cassette so that execution 
can continue. 

An illegal switch was indicated in the 
command line, where 'x* represents the 
switch in error. The check is made 
for as many as 10 illegal switches in 
any one command line. Typing any 
character on the keyboard will cause 
PIP to ignore the switch and continue 
execution. 



Continued on next page) 
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Table 8-2 (Cont.) 
PIP Error Messages 



btessage 


Meaning 


?TAPE PULL 
?TAPE FULI.7 

?WRT LOCK X 


Available space for an output file in 
full. A qiiestlon mark following the 
message Indicates that the error is 
not fatal? the aser may mount another 
cassette and type any character on the 
keyboard to continue execution. 

The cassette la vrrite-locked; x 
represents the drive number. The \iser 
should dismoyiit the cassette (the 
OFFLINE error message will then be 
printed), wrlte-enable the cassette, 
and remount it. Execution will 
continue. 
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CHAPTER 9 
IMPUT/OUTPUT Pre:«RAM4ING 



The majority of 1/0 in the CAPS-11 System is done using RESMON, the 
part of the Monitor which contains routines to handle all file 
structured cassette I/O and all teleprinter, keyboard and line printer 
input and output. 

RESMON is brought into raemory by bootstrapping the syste» or by typing 
a CTRL/C [K) while running another system program, RESMON loads the 
following interrupt and trap vectors: console terminal keyboard and 
printer, line printer, cassette, timeout, breakpoint, illegal imemory 
reference, stack overflow, power fail, EHT, TRAP and lOT. The RESMON 
I/O handlers remain in memory unless the user does an overlay load 
{using the Monitor LOAD coinmandr see Chapter 3), 

Simple I/O requests can be made by specifying devices and data forms 
for interrupt-controlled data transfers. These requests can be 
occurring concurrently with the execution of a running user programi 
multiple 1/0 devices may be running single or double buffered I/O 
processing simultaneously. 



9.1 COMMUNICATING WITH RESMON 

HESMDM cofflmands can be divided into two categories s 

1. Those concerned with establishing necessary conditions 
for performing input and output, and 

2. Those concerned directly with the transfer of data. 

When transfer of data is occurring, TiEShVm is operating at the 
priority level of the device. The calling program runs at its own 
priority level, either concurrently with the data transfer, or 
sequentially. Before using data transfer commands, note the 
fol lowing s 

I. Device specifications are made by referencing device 
numbers. Devices and their corresponding nunfcers aure 
listed in Table 9-1. 
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2, i^& buffer, whose address is specified in the code, in 
rrost cases imist be set up with information about the 

data. 



In non-data transfer commands v^ere an address or device nunber does 

not apply, the device ntmtjer should be set to zero; the address is 
ignored by RESMON and inay be any number. Addresses or codes may be 
specified syirfoolically. 

C(»HT»uni cation with RESMON is accomplished by lOT {Input /Out put Trap) 
instructions in the user's prc^ram. Each lOT is follewed by two words 
consisting of one of the RESMOH commands and its operands in the 
following format i 

lOT 

*BYTE (command code) , (device #) 

.VrOHD (address) 

As an exainple, the following prograin segn^nt illustrates a simple 
input-process-output sequence. It includes the setting up of a single 
buffer, a formatted ASCII HEAD into the buffer, a wait for conpletion 
of the READ, processing of data just read, and a WRITE command from 
the buffer, (HBSMON commands used in this example are explained in 
detail later in the chapter. ) 



000001 
000005 
000003 
0i0004 



RESET- I 
READ* 5 
WA1TR=3 
WRITES 4 



i ASSI QH 
I CODES 



RESMON C0M[1rt^JD 



000000 000004 START: 

000002 001 

000003 000 

000004 00B000 



lOT 

.BYTE RESET* 

•WORD 



J ISSUE RESET lOT 



000006 000004 KREADi 

000010 005 

000011 003 

000012 000130' 



000014 000004 WAIT: 

000016 003 

000017 003 



lOT 

»ByTE READ, 3 

.WORD SUFFER 



lOT 

.BYTE WAITR*3 



000020 B000I4' .WORD WAIT 

* 

(process buffer) 



I TRAP TO RESMOM 

I SPECIFY SUFFER PtiD READ 

tFROH KBD < DEVICE 3) UNTIL 
I LINE FEED OR FOWi FEED 

iTRAP TO RESMON 

I WAIT FDR KBD C OEVI CE 3> 

I TO FIMISH 

iBUSr RETURN ADDRESS WHILE 

I WAITING FOR KBD TO FINISH 



000t2S 000004 
000124 02A 

0001£S 00S 

000126 000130* 



IDT 

.BYTE WRITE* 2 

.WORD BUFFER 



000130 000100 BUFFER: 100 



000 13S 000000 
000134 000000 







000236 


. = . +• 1 00 


000000 


,mD START 



t TRAP TO RESMCW 
JWITE TO TELEPRINTER 

I C DEVICE a>, SPECIFY BUFFER 

J BUFFER SI2E in eYTES 
iCODE FOR FORMATTED ASCII 
JrtODE* RESMON WILL SET HERE 
I WE MUMBER OF WTES READ 
1 STORAGE RESERVED FOR 100 
IBCTES 






In more complex prograraraing it is likely that more than one buffer 
will be set up for the transfer of data, so that data processing can 
occur concurrently rather than sequentially, as here* 



9,2 DEVICE ASSIGNMENTS 

I/O devices in the CAPS-11 System are fixed. The programmer 
references then by using HESMON and si^ecifying a device number from 
Table 9-1. The device assignment numbers ares 



Table 9-1 

Device Assignments 



Device 


Number 


Cassette Drive 
Cassette Drive 1 

Console Terminal Printer 
Console Terminal Keyboard 
Line Printer 



1 

2 
3 
4 



Thus, in the following example: 

lOT 

.BYTE READ, 1 

.WORD STORE 

data ifl read from device 1, which is cassette drive 1. 



9. J BUFFER ARSANGEHEHT IH DATA TJRANSf^R COMMANDS 

Use of the data transfer ccwimands (IffilAD and wmte) requires the 
setting up of at least one buffer. This buffer is used not only to 
store data for processing » but to hold information regarding the 
quantity, form, and status of the data* All formatted I/O and all 
unformatted I/O (excluding unformatted cassette I/O) use one type of 
buffer; unformatted cassette I/O requires a special buffer. 



9.3,1 Buffer Arrangement for Formatted i/o 

and unformatted I/O (Excluding Cassette) 



The buffer area for all I/O except unformatted cassette consists of 
two sections: the buffer header and the buffer itself. The non-data 
portion of the buffer is called the buffer header emd precedes the 
data portion. In data transfer consmands, the address of the first 
word of the buffer header is specified in the second word after the 
lOT coimand. 
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NOTE 

RESMON uses the buffer header while 

transferring data. The user's program 
must not change or reference it (other 
than to check status bits). 



The arrangement of the buffer is as follows i 



BUFFER SIZE (in B^tes) 



STATUS 



MODE 



BYTE COIMT 



DATA 



Buffer Size 

The first word of the buffer contains the iBaxinum size (in bytes) of 
the data portion of the buffer and is specified by the user as an 
unsigned integer. SESMON will not store more tham this isany data 
bytes on input. Buffer size has no meaning on output. 

Mode Byte 

The low-order byte of the second word holds information concerning the 

node of transfer. A choice of four modes exists j 



Mode 



Coded as: 



Formatted ASCII 000 

Formatted Binary 001 

Unformatted ASCII 002 

Unformatted Binary 003 



(or 200 to suppress echo) 



(or 202 to suppress echo) 



The term echo applies only to the console terminal keyboard. Data 
transfers from other devices never involve an echo. A diagram 
illustrates the format of the Mode Bytet 





7 


e 


5 


i 


3 


t 








J 


















NNOKCmO* 
t>=ECHO - 

UUNfORMA 

OsfOBMamE 

1 ■ aiNARlf 


J 




































0«A5Ca 

*H0 KHO S(T fOd KEYBOARD ONir 



Figure 9-1 Mode Byte 



Modes are further discussed in Section 9,4. 
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status Byte 

The high-order byte of the second word of the buffer header contains 
information set by RESMON on the status of the data transfer as 
follows J 



Bits 0-4 

Bit 5 

Bit 6 
Bit 7 



Contain the non-fatal error codes 
octally; s^ Table 9-2) 



(co(ted 



i = Bnd-Of-File has occurred (attempt 
reading data after an End-Of-Medium) 

1 - End— of -Medium has occurred 

1 = Done (Data Transfer complete) 



ielt 



Thus, this byte is set up as follows: 



7 


6 


5 


4 3 2 i 





1 = 
DONE 


1 = 
EOM 


1 = 
EOF 


1)11 
SEE CODES 

III! 



NON-FATAL ERRORS [CODED OaALLY)- 



DT 



Figure 9-2 Status Byte 



Non- fatal error codes for the Status Byte are described in Table 9-2. 



Table 9-2 
RESMON Non-Patal Error Codes 



Error Code 


Meaning 


1 = block check error 

2 = dheckauHi error 


A block check error can occur on 
any cassette read (hard srrori 
RESMON cannot read the block) . 

A checksum error can occur only on 
a formatted binary REM)? (see 
Section 9.4.3), 



CCtontinued on next pag€!) 
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Table 9-2 (Cont,) 
RESMON Non-Fatal Error Codes 



Error Code 


Meaning 


3 = truncation of 

a long line 

4 = iniiJKOper racxie 


Truncation of a long line cart occur 
on either a formatted binary or 
formatted ASCII READ <aee Section 
9.4,1). This error occurs when the 
binary block or ASCII line is 
bigger than the buffer siz;e 
specified in the buffer header. In 
both cases, RESMOT continues 
reading characters into the last 
byte in the buffer until the end of 
the binary block or ASCII line is 
encountered. 

An improper laode can occur only on 
a formatted binary READ, Such 
occurrence means that the first 
non-null character encountered was 
not the proper starting character 
for a formatted binary block (see 
Section 9.4,3) . 



When the data transfer to or from the buffer is complete, the Done Bit 
(bit 7) is set by nP.St^n, 

The following conditions cause the EOM Bit (bit 6) to be set in the 
Buffer Status byte, (An EOM occurrence also seta the Done Bit,) 



lilne Printer 

No paper 

No power 

Printer drum gate open 

Over temperature condition 



Cassette 

+S detected during 
formatted ASCII input 



An End-Of-Medium condition occurring during use of the line printer is 
cleared by a manual operation such as putting paper in the line 
printer. RESMON does not retain any record of an EOM, 

When an End-Of-Medium has occurred during a READ from cassette, there 
may be data in the buffer. If an EOM has occurred during a WRITE to 
the printer, there is no way of knowing how much of the buffer was 
written. 

The following conditions cause the EOF Bit (bit 5) and the Done Bit to 

be set in the Buffer Status bytes 

1, File gap or clear trailer encountered during a READ from 
cassette, 

2, Clear trailer encountered during a WRITE to cassette. 
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When an End-Of-Pile occurs during a READ, the byte count is set to 
reflect the amount of data actually read. When an, EOF occuris during a 
WHITE, there is no way of determining how much of the buffer was 
actually written. 



Byte Count 

The third word of the buffer header contains the Byte Count determined 
as follows: 



Type of Transfer 
Input ! 



Output ! 



Action 

During unformatted transfers frort the 
keyboard, RESMON reads as many data bytes as 
the user has specified. During formatted 
transfers from cassette or keyboard, RESMON 
inserts in this location the number of data 
bytes available in the buffer. During 
formatted ASCII mode from cassette, if an E<M 
or EOF occurs, RESKCXI will set the Byt^ Count 
equal to the ninnber of bytes actually read. 
See Section 9,3.2 for information concerning 
unformatted cassette input. 

The Byte Count determines the number of bytes 
output for all nodes, A line printer 
out-of-paper condition will also terminate 
output and EOM will be set in the Status 
Byte, RESMON does not modify the Byte Count 
on output. 



9.3.2 Buffer Arrangement for tinforwatted Cassette 

The distinction between formatted and unformatted cassette I/O is made 
at the time a cassette file is opened for input or output (at SEEK or 
ENTER tine— see Sections 9.6.1 and 9,6,3). The mode specified at that 
time governs the way subsequent READs or WHITES are interpreted for 
the opened file. In the special case of unformatted 1/0 to or from 
cassette, the buffer pointer in the REJiD or WRITE J<ys cranmand is 
assumed to point to a 128 byte buffer without a buffer header, and not 
to a buffer as previously described. The buffer specifications for 
unformatted cassette I/O made at SEEK or INTER time are ignored. 
During an unformatted READ from cassette, a 128 byte data block is 
read directly into the buffer indicated by the second word of the 
parameter block. (See Sections 9.7,1 and 9.7.2 for a description of 
the parameter block). During an unformatted WRITE to cassette, 128 
bytes of data are taken diirectly from the buffer indicated and 
t r ans f e r red to cas s e t te . 



9 . 4 MODES 

Modes have already been mentioned in 
detailed description of each type. 



Section 9.3? following is 
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9.4.1 Formatted ASCII 

A formatted ASCII REiy3 transfers 7-bit characters (bit 8 is zaro) 
until a line feed or form feed is encountered, RESMON seta the Byte 
Count word in the buffer header to indicate the number of characters 
in the buffer. If the line is too long, characters are read and 
overlaid into the last byte of the buffer until an EOM or an 
end-of-line (indicated by a line feed or form feed) is detected. 
Thus, if there is no error, the buffer will always contain a line feed 
or form feed, 

A formatted ASCII WRITE transfers the nuitiber of 7-bit characters 
specified by the buffer Byte Count. Bit 8 will always be output as 
zero. 



Device-dependent functions for the console 
printer, line printer, and cassette follow. 



terroinal keyboard and 



Console Tenrtlnal Keyboard 

Seven-bit characters read from the keyboard are entered in the buffer 
and are echoed on the console terrdnal witJi the following exceptions: 



Null 



Ignored, This character is 
transferred to the buffer. 



not echoed or 



Tab 

(CTRL/TAB 
keys) 

RUBOUT 



CTRL/U 



Echoes as spaces up to the next tab stop, 
"Stops" are located at every 8th carriage 
position. 

Deletes the previous character on the current 
line and echoes the character deleted. If 
there are no characters to delete, RUBOUT is 

ignored. 

Deletes the current line and echoes as fU 
followed by a carriage return/line feed. 



Carriage 
Return 
(RETURN key) 



CTRL/O 



Echoes as a carriage return follcrwed by a 
line feed. Both characters enter the buffer. 



Echoes as +C follcs^ed by a carriage 
return/line feed aid a "?", The user should 
wake sore that the System Cassette is nreunted 
on drive Q; typing any character in response 
to tJie "?" will reboot the system. ?If the 
system is intact in memory, no *?* is printed 
since no reboot is necessary— the KBL is 
merely restarted.) 

Echoes as +0 followed by a CR/LF. Console 
terminal output is supressed until eithers 

1. K> is typed again, which causes 
teleprinter output to be resumed j 
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2. The program which is 
requests keyboard input? 

3, The program executes 
RESET lOT (lOT #0) ', 



executing 
the CTKL/O 



CTRL/P 



4, +C is typed. 

5, The program executes the RESET lOT 
(lOT #1) . 

6, The program executes a prompted 
SEEK, SEEKF, or ENTER command 
(Section 9.6.3). reshon enables 
teleprinter output so the prompt 
message will be seen. 

If +0 is typed during a keyboard input 
coratnand, it will be echoed but will not be 
passed to the buffer r keyboard input will 
continue to be echoed as ussual, 

Edhoes as +P and causen a jump to the restart 
address, if a non-2:ero restart address was 
specified via the RESTART lOT tlOf #2? see 
Section 9,5,2) . 



Lower Case 

ASCII 



- The ASCII codes 141-172 (lower case a-SE) are 
converted to the codes 101-132 (upper case 
K-Z) on input and are echoed and stored in 
the buffer as such. 

The echo may be suppressed by setting bit 7 of the buffer header Mode 
Byte. 

If the buffer overflows, only the characters which fit into the buffer 
are echoed. Characters which are deleted by RUBOUT or CTKL/U do not 
read into the buffer even though they are echoed. If a carriage 
return causes an overflow, or if a carriage return is typed after an 
overflow has occurred, a carriage return/line feed will be echoed but 
only the line feed will enter the buffer. 

In the following formatted ASCII examples, assuipie there Is rooii for 
five characters in the buffer, ^ indicates typing a carriage return, 
\ represents typing a line feed, rubout represents typing the RUBOIfC 
key, and CTRL/tl indicates that the CTRL/O cojribl nation has been typed. 
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User 
Typed; 

ABC ) 

ABCD J 

ABCDEF ) 

ABCDEF RUB j 

OUT '' 

CTRL/U RUB \ 
OUT 



Echoed on 
Console Terminal: 



ASCII Code 

Entered into Buffer: 



ABC^I 


ABC^I 


ABCD J \ 


ABCD^ 


ABCD } \ 


ABCD| 


ABCDD^ \ 


ABC^I 



+u J \ 



>\ 



ABCDEF RUB RUB 
OUT OUT 



ABCDDC^ \ 



ABCDEF RUB RUB RUB X J ABCDDCBX^ \ 
OUT OUT OUT ' 



AX^ I 



Console Terminal Printer 

Characters are printed from the buffer as they appear except that 
nulls are ignored and tabs are output as spaces up to the next tab 
stop. 



Line Printer 

Characters are printed from the buffer as they appear except as 
follows : 

Nulls - Ignored, 

Tab - Output as spaces up to the next tab stop. 

Carriage - Ignored. It is assumed that a line feed or 
Return form feed follows. These characters cause 
the line printer "carriage" to advance. 

All characters beyond the 132nd (or 80th if the optional line printer 
is used) are printed on the next line; RESMON issues a CR/LF and 
continues output. 



Cassette Input 
Nulls 
Rubout 
CTRL/Z 



- Ignored, 

- Ignored, 

- Sets Done Bit suid EOM Bit (bit 6) in Buffer Status 
byte. 
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Cassette Output 

Characters are transferred from the buffer as they appear. Whan a 
formatted ASCII cassette file is closed, the Monitor writes a +S into 
the output block and pads the unused portion of the block with nulls. 



9.4.2 unformatted ?iSCII 

Unformatted ASCII m:m>s and WRITEa transfer thffi number of 7-bit 
characters specified by the header Byte Count. {See Section 9.3.2 for 
information cm unformatted transfers using cassette.) 

Device-dependent functions include only the keyboard. Characters are 
read and echosd except as follows! 

Tab - Echoes as spaces up to the next tab stop. 

CTRL/P - Same as formatted ASCIX. 

CfHL/C - Same as formatted ASCII. 

CTHL/O - Same an formatted ASCII. 

Lower Case 

ASCII - Same as formatted ASCII. 



9.4.3 Pomiatted Binary 

Formatted binary is used to transfer checksunmed binary data (8-bit 

characters) in blocks. A formatted binary block appears as follows s 

Byte (octal) Meaning 

001 - Start o£ block (output automatically by 
RESMOM) , 

000 - Always null (output automatically by 
RESMON) . 

XXX - Block Byte Count (low-order followed by 
3CXX high-order) . Count includes data and 

preceding four bytes (output 

autoiEtatically by KESMON) . 
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DDD 
DDD 



- Data bytes (from user's buffer). 



DDD 
DDD 

CCC - Checksum. Negation of the sum of all 
preceding bytes in the block (output 
automatically by resmon) . 

BESMOU creates the block during output frcm the buffer and buffer 
header. The Byte Count word in the buffer header specifies the nuniber 
of data bytes ^ich are to be output. Note that the number of bytes 
output is four larger than the header Byte Count. As the block is 
output, BESMON calculates the checksimi which is output following the 
last data byte. 

On formatted binary MADs, RESMON ignores null characters until the 
first non-null c±iaracter is read. If this character is a 001^ a 
formatted binary block is assumed to follow and is read from the 
device under control of the Byte Count value. If the first non-null 
character is not 001, the READ is immediately terminated and error 
code 4 {see Table 9~2) is set in the Status Byte. As the block is 
read a checksum is calculated and compared to the checksum following 
the block. If the checksum is incorrect, error code 2 is set in the 
status Byte of the buffer header. If the binary block is too large 
(i.e., [Byte Comiit-4] larger than the buffer size specified in the 
header) , the last byte of the buffer is oimrlaid until the last data 
byte has been riead; error code 3 is set in the Status Byte, 

Device dependent functions do not apply to formatted binary READs and 
WRITES. Bight-bit data characters are transferred to and fr<:^ the 
device and buffer exactly as they appear. 



9.4,4 Unformatted Binary 

This mode transfers 9-bit characters with no fo3:inatting or character 
conversions of any kind. For both input and output ^ the buffer header 
Byte Count determines the number of characters transferred. (See 
Section 9.3.2 for information on unformatted transfers using 
cassette. ) 

Device dependent functions do not apply. 



9.5 NON-DATA TRftNSPER COMMANDS 

The following commands are needed for initialization before any I/O 



3-12 



The RESET command must be the first t^SMON compiand issued by a user 
program and takes the forms 

.BYTE 1,0 
.WORD 

It initializes many of RESM(»i*s internal flags, resets all devices to 
their state at power-up Ca hardware RESET instruction is issued) 
enables keyboard interrupts, clears the +0 flag, and clears the ^P 
BESTAB3' address (set by the RESTART lOT) , This lOT is normalljf issued 
only at the start of a user's pixsgram. it takes a significant amount 
of tiirte to complete since RESM0N goes into a timing loop and then 
issues a hardware BESET instruction. if this were not done, the last 
characters printed on the console terminal could be garbled. 



9.5.2 RESTART 

The RESTART cowMind designates an address at which to restart a 
program. The format of the cownand is : 

lOT 

.BYTE 2,0 

.WORD (address to restart) 

After this coiwraand has been issued, typing CTRL/P on the Jteyboard will 

transfer program control to the restart address, if the restart 
address is designated as 0, the CTRL/* restart capability is disabled. 

The RESTART cotrtttiand cancels keyboard interrupts. It is the program's 
responsibility to clean up any 1/0 in progress and to ensure that the 
Stack Pointer is reset. 

It is a good programming practice for the code at the restart ^address 
to check if any cassette output files were open when t-P was typed and 
to close them before actually restarting normal program execution. It 
is also advisable to issue a SffiSET JOT after a tp restart and before 
any BESMON data transfer coirananda are issued. 



9,5.3 CNTRLO 

The CNTRLO conmand resets the RBSMON to flag, thus enabling future 

console terminal output. The format is: 

JOT 

.BYTE 0,0 
.isfOIlD 

The +0 flag (which suppresses console terminal output) is set by ti^ 
user typing +0 on the keyboard. The flag is cleared (thus enabling 
teleprinter output to continue) when one of the following occurs j 
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1. '^0 is typed again, 

2, The program running in memory requests keyboard input. 

3, +C is typed, 

4. The program running issues cMTKLO iot, 

5. The program running issues HKKET IOT, 

6, The program running issues a prompted SEEK, SERKP, or 
ENTER IOT Csee Section 9.6,3, User Prompting). 

9.6 CASSETTE PILE I/O COMMANDS 

The following KEBMON coramands are used for setting up I/O transfers. 



9.6.1 SEEK 

The SIEK command ia for cassette only and is used to open a cassette 
file for input. tjug^; gets up infomation which RESMON uses in 
subsequent BEAD'S from the specified unit. The format of the SEEK 
coromand iss 

IOT 

.BYTE 10, device i — device or 1 only) 

.WOHD (pointer to list of arguments for SEEK) 

The list of arguments for the SEEK coBsmand appears as: 

.BTTl Status/Error, (ftode) 

.WORD (address of 128 byte buffer for use when reading 

cassette blocks if formatted mode is specified; 
otherwise 0) 

.WORD (address of a second 128 byte buffer if double 
buffered input is desired? otherwise 0) 

.WORD (address of 32 byte buffer for storage of 
file headers while SEEKing) 

.WORD (address of filename to SEEK| 

.WORD (address to return to if error detected) 

The 32 byte buffer for file headers is the area into which RERMDN will 
read file headers as it is looking for the specified file. This 
buffer is a scratch area and will generally be the same for every SEEK 
coraraand the user has in his program. The address of the filename to 
SEEK is a pointer to an area containing the filename and extension 
properly padded to nine bytes (if necessary) , which is to be looked 
for on the specified cassette unit. For formatted I/O, the address of 
the 128 byte buffer tells RESMON where to read cassette data blocks 
onc« the specified file has been found. RESMON reads blocks into this 
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buffer from cassette and then takes data from, this buffer and moves it 
to the user's line buffer to fulfill a MEAD lOT. If the user 
specifies a second 128 byte buffer, RESMDN will use it to impleinent a 
do-uble buffered Input scheme for subsequent jREAD's on that device. 
For unformatted I/O, the buffer specifications are ignored, 

RESMON sets the Status/Error Byte in the list of SEEK argujiKtnts to 

reflect errors, as follows: 

Bit set Error 

7 Error detected 

6 Pile not found 

5 Hard error 

4 Conflict (e.g. output file was open) 

3 No I/O buffer specified for forroatted I/O 

On detection of rni error, RESJTON sets bit 7 and one other hit in the 

error byte and transfers control to the error address specified in the 
list of arguiaents. 

If no error was detected, SEEK returns with the header of the desired 
file in the user- specified scratch area and with the cassette 
positioned to HEAD the first data block of the file. No data bl<x;!cs 
are read as a result of a SEEK. The SEEK command always r^finds the 
specified cassette before doing a seek (sequential search?. 

NOTE 

If the first byte of an extension specified by the 
user in a SEEK or SEEKF command is 000, RESMON 
will not attempt to match the extension , hut 
rather will look for the first file which has the 

same filename. 

If the first byte of a filename specified by the 
user in a SEEK or SEEKF corroand is OOO, RESWDN 
will not compare filenames at all, but rather will 
position the cassette so as to read the first file 
encountered. For SEEK, this is always the first 
file on the cassette, since the tape is always 
rewound first. For SEEKF, this is the first file 
encountered spacing forward from the current 
position. 



9.6.2 SEEKF 

The SEEKF (SEEK Forward) command is identical in format and operation 
to the SEEK command, except SEEKF does not perform a rewind before 
searching for the specified file. The format of the command is: 

lOT 

.BYTE 11, (device #) 

.WOHD (pointer to list of arguments for SEEKF) 

The list of arguments is the sane as for SEEK and can be fotand in 
Se ction 9.6,1, 
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9.6.3 ENTER 

The ENTER confimand is for cassette only, and is used to create a new 
file on cassette (at the logical end of cassette) * The fon^at of the 
coinmanci is : 

lOT 

.BVTE 7, (device #) 

.WOKD (pointer to list of ENTER arguments J 

The list of arguments for the ENTIR command is similar to the list of 
argiunents for the SEEK commands : 

.BYTE Status/Error, (Mode) 

,W0H0 (address of 128 byte buffer for use in writing 
cassette blocks in formatted i»ode; otherwise 0) 

.WORD (address of second 128 byte buffer if double 

buffered output is desired? otherwise 0) 

,WORD (address of 32 byte buffer for storage of 
file headers) 

.WORD (address of filename to be INTERed) 

.ITORD (address to return to if error detected) 

,l\fORD (address of o%?erflow subroutine to be called if a 
formatted file hits end-of-tape before it is 
closed; otherwise 0) 

The ENTER command rewinds the specified cassette unit and does a SEEK 
for the filename supplied by the user. (ENTER assumes that the 
filename address supplied by the user is the beginning of a 32 byte 
header to be written out as the header block of the file being 
ENTERed. See Appendix F for a complete description of the cassette 
file header.) If the file is found, it is deleted by overwriting the 
existing header with an "♦EMPTY" header. The ENTER command then moves 
down to the logical end of cassette and Ksplaces the end of cassette 
marker with the header specified by the user. The cassette is left 
positioned to write the first data block of the new file. Before 
writing the new header, ESSMON performs several operations t the 
sequence and continuation bytes of the user- specified header are set 
to zero I the length is set to 128 bytes per data record? if the first 
two bytes of the date are zero (or spaces— ASCII 240) , RESMON will 
supply the current date (if the user specified a date with the Monitor 
DATE copmand) . 

For formatted I/O, the 128 byte buffer in the list of ENTER arguments 
is an intermediate buffer which RESMON uses in writing data blocks of 
the EMTERed file. The user norwally issues a WRITE lOT specifying a 
line buffer; RESMON takes data fron the line buffer and moves it to 
the user-specified 123 byte buffer; when this 128 byte buffer is full, 
it is written out to cassette. If the user supplies the address of a 
second 128 byte buffer, RESMON will double buffer cassette output for 
this file. Buffer information from the ENTER is stored by RESMON for 
reference during I/O to the specified unit. For unformatted I/O the 
buffer specifications are ignored. 



9-16 



The Mode Byte in the list of argianents is similar to the Mode Byte in 
the SEEK coininand— it indicates how the user intends to write the file 
being ENTERed and is stored by RESMON for reference during I/O. It 
can have only the values listed in Section 9.3.1 under "Mode Byte". 
The Stat us /Error Byte in the list of ENTER arguments is set by RESMON 
to reflect errors detected during the ENTER function; following is a 
list of the error bits: 

Bit Set Error 



7 Error detected 

6 Full tape (clear leader found) 

5 Hard error 

4 Conflict (output file was 

open) 
3 No I/O buffer specified for 

formatted I/O 

If an error is detected, RRSMON sets bit 7 and one other bit and 
transfers control to the error address specified in the list of 
arguments. 

The last item in the list of ENTER arguments is an overflow subroutine 
to be called in case the user ENTERS a formatted file and the WRITE 
processor encounters the end of cassette before the file is CLOSEd. 
If an overflow subroutine was specified when the file was ENTERed, the 
WRITE processor will call it via a JSR PC,SUBR. The user's subroutine 
should tell the user to mount a new cassette on the same drive that 
the file which overflowed was mounted on. It should then ENTER a file 
on that new cassette (using the same internal buffers as the original 
ENTER command) and then return to RESMON 's WRITE processor via an 
RTS PC. The WRITE processor will continue writing onto the new file; 
the two files should then be combined with PIP before being used 
further. RESMON saves registers 0-5 before calling the user 
subroutine, so the user need not worry about destroying the contents 
of these registers. However, the user should be careful not to 
destroy the stack pointer (Register 6) . 



User Prompting 

The commands SEEK, SEEKF, and ENTER have an additional feature which 
can aid the user who has his files on many different cassettes. If, 
on entry to these commands , the Status/Error byte in the list of 
arguments is equal to 377 (octal) RESMON will prompt the user to mount 
a new cassette on the unit specified for the command. RESMON will 
type: 

#? 

where "#*• is the unit number on which RESMON expects a new cassette to 
be mounted. RESMON then waits for the user to type any character on 
the keyboeird. When the user has done this, RESMON assumes that the 
proper cassette has been mounted and initiates the command. 

Chapter 3 provides more details concerning user prompting. 
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Non-Fatal Off-Line and Write-Lock Errors 

SBEK, SEEKP, and ENTER have the ability to detect write-lock and 
off-line (no cassette mounted} errors and allow the user to correct 
them without atsorting the conwand in progress. When one of these 
commands is initiated, if there is no cassette mounted on the 
specified unit, the massage: 

70PPLIKE B 

will be generated. The user should mount on unit n the cassette 
containing the file he wishes to SiEK or the cassette on which he 
wishes a new file ENTEited. RESKON will automatically proceed with the 
specified coranand. No action other than mounting the cassette is 

necessary. 

Likewise, when an ENTER coimnand is initiated, if the cassette mounted 
on the specified unit is write- locked, RESMiN will generate the 
it^ssage: 

?wm* LOCK n 

The user should dismount the cassette, write-enahle it, and renount 
it. IffiSMON will continue with the specified ENTER copmand 

automatically. 

NOTE 

When the user dismounts the cassette, he 
will also see the *'?OPPLlNE n" message 
described above. 



9.6.4 CLOSE 

The CLOSE comniand is for cassette only and specifies that a certain 
file presently open for output is to be closed and not referenced 
further. 

HOTB 

CLOSE may be issued for any device, but 
it is ignored for the console terminal 
keyboard and printer, and line printer. 
It is also ignored if no output file is 
open on the specified unit. 

The fojrmat of the osmmand int 

lOT 

.BYTE 6, (device #) 

.WORD (address for transfer if error detected) 

CIjOSE frees the unit so that it may be opened again via a SEEK, SBBKF, 
or EMTER, If CLOSE is issued for a unit which is 0|»n for input, no 
error will occur but control will return immediately to the user. 
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In the case of unfonnatted ASCII and binary files, CLOSE waits until 
the last WRITE initiated is completed, then writes an end-ef-tape 
marker and rewinds the cassette. If the user Initiates an unformatted 
WRITE and then iitmediately does a CLOSE, the CLOSE processor has to 
wait until the WRITE is completed before it can start to write an 
end-of-tape marker. The error return is never taken for unfonnatted 
CLOSES. 

If a formatted output file is open, CLOSE must write out the last 
portion of RESMON's internal buffer <if there is any data in it), 
write an end-of-file on the cassette, and rewind the cassette. 
Control is returned to the user once the rewind has been initiated. 

In the case of a formatted ASCII file open for output, CLOSE will 
supply a +Z (ASCII 32) as logical end-of-file, pad the rest of the 
last data block with nulls, write out the last data block, write the 
end~of-tape taarker, and rewind the cassette. 

In the case of formatted binary files, CLOSE writes out the last data 
block with any unused portion of it padded with nulls, writes the 
end-of-tape marker, and rewinds the cassette. 

The only possible error which may occur during a formatted CXOBB is 
clear leader or full tape? this error is detected when RBSMON writes 
out the last portion of the internal buffer. If this WRITE is not 
successful, the error return is taken. If clear leader is detected 
when writing the end-of-tape marker, it is ignored. 



9.7 DATA TRANSFER COMMANDS 

The following lOT's are used to transfer data between devices. 

9.7.1 READ 

The iffiAD command causes BESMON to read frcm the device associated with 
the specified device number according to the information found in the 
buffer header. The foimat of the ccBmnand is: 

lOT 

.BYTE 5, (device #) 

.WOHD (address of first word of the buffer header} 

or 
.WORD (address of parameter block) — for xm formatted 
cassette READS 

For unformatted cassette READs, the parar*eter block has the following 
form; 

.BYTE Status/Error, 

.WORD (address of 128 byte buffer for READs) 

RESMON initiates the transfer of data, clears the status Byte, and 
returns control to the calling program. If the device on the selected 
channel is busy, or if a conflicting device (see Section 9,7,3) is 
busy, RESMON retains control until the data transfer can be initiated. 
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Upon completion of the READ, the appropriate bits in the Status Byte 
are set by RESMON and the Byte Count word indicates the number of 
bytes in the data buffer. 

For formatted cassette READs the flow of execution is as follows s 

RESMON reads a data block into an intermediate cassette buffer 
(specified by the user at SEEK tine) . From that buffer, RESMON pulls 
characters one at a time and uses them to fill the buffer specified by 
the user in the READ command. The user buffer is filled exactly as if 
the characters were coming directly from the cassette and the process 
is governed as described in Section 9.3.1. If, at SEEK time* the user 
specified a second intermediate buffer, the cassette I/O is double 
buffered, thus minimizing the amount of time the user program, must 
wait for physical I/O transfers. Note that the user can impleit»nt his 
own double buffering scheme by using unfomatted cassette I/O, since 
in that case the location of cassette buffers is not fixed at SEEK or 
ENTER time, but can be varied with every READ {or WRITE) coramand 
simply by changing the buffer pointer in the comnand (see Secticai 

For formatted cassette READs, RESMON will set the Status Byte in the 
buffer header to reflect the status of the data transfer as described 
in section 9.3,1, Status Byte. For unformatted cassette READs the 
Status Byte in the parameter block is set to reflect the status of the 
operation as described in the section on Cassette 1/0 Primitives 
{Section 9,8). For formatted cassette reads, the Done Bit will be set 
when the user's buffer has been filled, even though there may be seme 
physical I/O still in progress. With regard to formatted cassette 
I/O, as a result of the intermediate buffering scheme the user's 
buffer will always be full when he regains control following a READ 
command since the data is coining frcsn a memory buffer. If the user 
tries to do a READ from cassette before doing a SEEK or SBEKF, the 
Monitor will give a "NO FILE OPEN n* u^ggage, where n is either or 1 
(for drive or 1). 



9.7,2 WRITE 

RESM<M writes on the device associated with the specified device 
number according to the information found in the buffer header. The 

format of the command is j 

lOT 

.BYTE 4, (device #) 

.WORD {address of first word of the buffer header) 

or 
.WORD {address of pararoeter block) — for unformatted 
cassette WHITES 

For unformatted cassette WRITEs, the parai^ter block has the form: 

.BYTE Status Arror,0 

.WORD (address of 128-byte buffer to WRITE) 

Transfer of data occurs in the amount specified by th& Byte Count 
(Buffer+4) , RESMON returns control to the calling program as soon as 
the transfer has been initiated. If the selected device is busy or a 
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conflicting device is busy, resmon retains control until the transfer 
can be initiated. Upon completion of the WRITE, RESMON will set the 
Status Byte to the latest conditions. If a WRITE causes an lOM 
condition, the user has no way of determining how much of hia buffer 
has been written (the Byte Count remains the same) . 

The WRITE command behaves the same way as the HEAD command with regard 
to formatted and unformatted cassette I/O, Mien control is returned 
to the user after a formatted ca.ssette WRITE, his line buffer is 
available. The status bytes for formatted and unformatted cassette 
WRITES are interpreted like those for cassette READs, 

If a WRITE is issued without first doing an ENTER <see Section 9,6,3) 
the Monitor will respond by typing a "NO FILE OPBK' n" message, where n 
is the drive number. 



9,7.3 Device Conflicts in Data Transfer Commands 

Because there is a physical association between the printer and 
keyboard on the console terminal, csrtain devices c«a\not be in use at 
the same time, VSien a data transfer ccHrmand is given, RESM^ 
simultaneously checks for two ccmditions before executing the coiwnandt 



1, Is the device requested already in use? 

2, Is there some other device in use that would 
an operational conflict? 



result in 



KESMON resolves both conflict situations by waiting until the first 
device is no longer busy before allowing the requested device to start 
functioning, (This is an automatic MJtlTR command; see the next 
section, > For example j, if the console terminal is in use, and either a 
KBD request or a second request for the terminal itself is made, 
RBSMOW will wait until the current output operation has been ccmpleted 
before returning control to the calling prograin. 

Table 9-3 lists the devices; corresponding to each device on the left 
is a list of devices (or the echo operation) which would conflict with 
it m op)eration. 



Table 9-3 
Device Conflicts 



Device 


All Possible Conflicting 
Devices or C^erationa 


Terminal Keyboard (kbd) 
Printer (TTY) 

Cassette (CTO or CTl) 

Line Printer (LP) 


Echo, KBD, TTY 

CTO, CTl 

LP 
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9,7.4 WAITR {Wait, Return) 

•Rie WAITR cormandl is usad to test the status of the specjified device. 
The format of the ccanraamd iss 

lOT 

.BYTE 3, (device #) 

,WORD (busy return address) 

If the device {or any possible conflicting device) is not transferring 
data, control is returned to the instruction following the WAITR 
cotnmand. otherwise, control is treinsf erred to the busy return 

address . 

Note that a not busy return from WAITR normally Kieans the device is 
available. However, in the case of a WRITE to the console terminal or 
line printer, this means only that the last character has been output 
to the device. The device is still in the process of printing the 
character. Thus, care imiat be exercised when j^rforming a hardware 
RBSEf or HAI.T after a WRITE-WAITH sequence, since these may prevent 
the last character front being physically output. 



WAITR vs. Testing the Buffer Done Bit 

WAITR tests the status not only of the device it specifies, but also 
of all possible conflicting devices. This means that when WAITR 
indicates that the device is not busy, the data transfer on the device 

of interest may have been completed for some tiine. Depending on the 
program and what devices are being used for a given run, the WAITR 
could have been waiting an additional amount of time for a conflicting 
device to becoEire free {i.e., waiting for the KBD when the TTY is to be 
used, or waiting for C?PO when CTl is to be used), Hhere this 
possibility exists and buffer availability is the Main concern, 
testing the Done Bit of the Status Byte {set when the buffer transfer 
is complete) would be preferable to WAITE; alteimately, 1*AITR would be 
preferable if device availability is the utain interest. 

In unformatted transfers to and from cassette, WAITR is equivalent to 
checking the Done Bit for the last READ or WRITE conunand. 

In formatted transfers to and from cassette, a WAITR is equivalent to 
checking whether there is any physical I/O occurring on the specified 
unit. The user is not generally concerned with this--noxinally he only 
wants to know when his line buffer is free if he is doing formatted 
1/0. Note that in this case even though no physical I/O is going on 
when the not busy return is taken, there rniay still be data in the 
user's intermediate cassette buffer (as specified in the SEEK or ENTER 
cotttmand) . WAITR would generally not be used when the programmer is 
writing/reading a cassette file in formatted mxie. 



9.7.5 Single Buffer Transfer on One Device 

The program segment below includes a WAITR which goes to a busy return 
address that is its own lOT, continuously testing device 3 for 
availability; in this case, only a single device and a single buffer 
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are involved, A done condition in the buffer 1 Status Byte can be 
inferred from the availabilty of device 3. This knowledge ensures 
that all data requested for Buffer 1 is available for processing. 



At lOT 

• BYTE READi 3 
. WORD BUFl 



STRAP TO RES!>«CW 

» SPECIFY BUFFER Ai^D 

»REflD FROM DEVICE 3 

UNTO BUFFER 



BUSYs lOT *TRAP TO ftESMON 

.BYTE WAlTR^a » WAl T FOR DEVICE 3 
.WORD BUSY » SPECIFY BUSY «ETURM 

» ADDRESS TO FINISH 
I READING 
(Process Buffer 1) 



J.IP A 

Testing the Done Bit of Buffer 1 might have pBBn used instead, but was 

not necessary with only one device of^rating. 



9.7.6 Double Buffering 

The example below illustrates a time-saving double buffer scheme 
whereby data is processed in Buffer 1 at the same time that new data 
is being read into Buffer 2; sequentially, data is processed in Buffer 
2 at the same time that new data is being read into Buffer 1. 

lOT J TRAP TO RESMON 

■ BYTE READ* 3 I SPECIFY BUFFER I 
• WORD BUFl I READ FROM DEVICE 
13 INTO BUFFER 1 



A: lOT 

.BYTE READ, 3 
, WORD BUF2 



fTRAP TO RESWfCN 
* SPECIFY BUFFER 2 
I READ FROM DEVICE 
i3 INTO BUFFER 2 
(process BUFl concurrently with RBAD into BUF2J 



Bi 



lOT 

.BYTE READ, 3 

.WORD BUFl 



jTRAP TO RESMON 
* SPECIFY BUFFER 1 
J READ FROM DEVICE 
*3 INTO BUFFER 1 



(process BUP2 concurrently with BEAD into BUFl) 



JMP A 



Because RESMON ensures that the requested device is free before 

initiating the command, the subsequent return of control from the lOT 
at h implies that the READ prior to A is complete ? that is^ that 
Buffer 1 is available for processing, Siinilarly, the return of 
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aontrol frcwn Uie lOT at B iptpHes that Buffer 2 is available, WAITR's 
are not required because HESMON has automatically ensured the devise's 
availability before initiating each HEAD. 



9.8 CASSETTE I/O PRIMITIVES 

RESMON also allows the sophisticated user to access the basic routines 
necessary for doing cassette I/O. "Hiis is dona by means of lOT's with 
the follcwing formats 

lOT 

.BYTE function, <device #) 

.WORD (pointer to argument list} 



These IOT'3 can access only cassette, i.e., device nvanbers 
The functions listed in Table 9-4 are valid. 



and 



Table f-4 
Cassette I/O Functions 



Function # 


Meaning 


12 


WHITE file gap 


13 


WRITE (see below) 


14 


READ (see below) 


15 


Space reverse file 


16 


Space reverse block 


17 


Space forward file 


20 


Space forward block 


21 


Behind 



For READ and WRITE, the list of argur«nts is as follcs^s s 

.BYTE Stat\is/Krror,0 
.WORD {buffer address) 
.WORD {byte count) 

For functions other than READ and WRITE the list of arguments is only? 

.BYTE Status/Error ,0 

Errors are reported in the Status/Error byte as follows: 

Bit set Meaning 



? 
6 
5 
4 
3 
2 
1 




Error Detected 

Block Checksum (on BSEAD) 

Clear Leader 

(not usedj 

File Gap Detected 

(not used) 

(not used) 

I3one 
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RESMON sets bit 7 and one (or more J other bits if an. error is 
detected, Write-lock, off-line, and timing errors cause a fatal error 
message and return to RESMON. 

RESMOM stores the high order byte of the cassette status and cominand 

register in the user's status error byte when an error is detected. 
The user should check error bits in the following orders 

1, Clear Leader 

2, File Gap 

3, Block Checksum 

Because of the nature of the cassette hardv?arer more than ons of these 
bits may be set. The above order should be used when checking the 
bits; only the first bit detected is significant. 

Bit of the Status/Error byte is set to 1 when the function is 
complete? control is returned to the user ae soon as the function is 

initiated. If jphyslcal cassette I/O is in progress wten one of these 
functions Is called, RESMQH will wait imtll tJie I/O is complete, 

initiate the desired function, and then return to the user. 



9.9 ERHOR MESSAGES 

The following error messages are detected in RESMOM (refer to Section 

3.7 of Chapter 3) : 



Table 9-5 
RESMON Error Messages 



Message 


Arg 


Meaning 


lOT 


PC 


An lOT was issued at the indicated 
location which referenced either an 
illegal RESMON co!wiand, illegal 
device, or illegal data mode. 


NO FII^ OPEN 


drive # 


User issued a cassette READ or 
mUTE without doing a SI:i:k or 
ENTER. 


OFFLINE 


drive # 


User attempted to access a cassette 
which was not mounted; execution is 
autonatically resupied when the 
cassette is mounted. 


TIMING 


drive # 


A timing error occurred on the 
drive indicated (RESMON tries the 
operation 3 times.) 



(Continued on next page) 
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Table 9-5 (Cont.) 
RESMON Error l-Sessages 



Message 


Arg 


immxinq 


TRAP 
WRT LOCK 


PC. 

drive # 


A stack ox^mrtlcM f attempt to 
reference a word on a byte 
boundary, or illegal inemory 
reference trap occurred at the 
location indicated. The stack 
pointer (R6) at time of error is 
saved in location 44. 

User attempted to WRITE on a 
write- locked cassette | execution ia 
automatically resijined when the 
cassette is write-enabled. 



9.10 EXAMPLE OF PROGRAM USING RESMON 



An BKainple of the use of RESMCM by both the CAPS- 11 
within a user progran is presented in Appendix D, 



System and from 
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APPENDIX A 
ASCII CHARACTER CODES 



A.l KEYBOARD DIFFERRNCES 

Certain console terminals vary concerning labeling of keyboard keys 
and characters output upon receipt of particular ASCII character 
codes. The following list should be referenced to determine possible 
differences i 

Keys Which Perforin Represent 
the Same Function the ASCII Code 



+ 




136 


■«- 




137 


RUBOUT 


DELETE 


177 


ESCAPE 


ALTMODE 


176 175 


SHIFT L 


\ 


134 


CTRL I 


TAB 


211 


SHIFT K 


[ 


133 


SHIFT M 


] 


135 
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A. 2 CHARACTER CODES 



The following is a list of the 7-bit octal ASCII character codes. 
(ASCII is an abbreviation for American Standard Code for Information 
Interchange. ) 



7-Bit 




7-Bit 




7-Bit 




7-Bit 




Octal 


Character 


Octal 


Character 


Octal 


Character 


Octal 


Character 


000 


NUL 


040 


SP 


100 


@ 


140 


space 


001 


SOH 


041 


! 


101 


A 


141 


a 


002 


STX 


042 


n 


102 


B 


142 


b 


003 


ETX(tC) 


043 


# 


103 


C 


143 


c 


004 


EOT 


044 


5 


104 


D 


144 


d 


005 


ENQ 


045 


% 


105 


E 


145 


e 


006 


ACK 


046 


& 


106 


F 


146 


f 


007 


BEL 


047 


1 


107 


G 


147 


g 


010 


BS 


050 


( 


110 


H 


150 


h 


Oil 


HT 


051 


) 


111 


I 


151 


i 


012 


LF 


052 


* 


112 


J 


152 


j 


013 


VT 


053 


+ 


113 


K 


153 


k 


014 


FF 


054 


f 


114 


L 


154 


1 


015 


CR 


055 




115 


M 


155 


m 


016 


SO 


056 


# 


116 


N 


156 


n 


017 


SI [to) 


057 


/ 


117 





157 


o 


020 


DLE ( tP) 


060 





120 


P 


160 


P 


021 


DCl 


061 


1 


121 


Q 


161 


q 


022 


DC2 


062 


2 


122 


R 


162 


r 


023 


DC 3 


063 


3 


123 


S 


163 


s 


024 


DC4 


064 


4 


124 


T 


164 


t 


025 


NAK 


065 


5 


125 


U 


165 


u 


026 


SYN 


066 


6 


126 


V 


166 


V 


027 


ETB 


067 


7 


127 


w 


167 


w 


030 


CAN 


070 


8 


130 


X 


170 


X 


031 


EM 


071 


9 


131 


Y 


171 


y 


032 


SUB(tZ) 


072 


* 


132 


Z 


172 


z 


033 


ESC 


073 


* 


133 


t 


173 


[ 


034 


FS 


074 


< 


134 


\ 


174 


(N) 


035 


GS 


075 


a 


135 


] 


175 


(]) 


036 


RS 


076 


> 


136 


+ C^) 


176 


<-) 


037 


US 


077 


? 


137 


"(_) 


177 


DEL 
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APPENDIX B 

MSEMBLY hmmhi^ simmmt 



B,l TERMIKft«)RS 
Character 
CTia,/PORH 
LINE FSEO 

mTurm 
% 

TAB 

BLftNH or 

SPACE 

# 

t 



I 

+ 



Function 

Source line terminator 

Source line terminator 

Source line tenninator 

Label tennitiator 

Direct assignment etelineator 

Kegiater t&tm delineator 

Item tecminator 
Field terminator 

Item terminator 
Field terminator 

Iimaediate expression field indicator 

Deferred addressing indicator 

Initial register field indicator 

Ttexminal register field indicator 

Operand field separator 

Corai?»entB field delimiter 

lUrithmetic addition operator 

Arithmetic subtraction operator 



iB***! 



Character 



Function 



Logical AND operator 
IiOGfical OH operator 
Etouble ASCII tejct indicator 
Single &SCI1 text indicator 



B.2 ADDRESS MODE SYKTjyC 

In the following syntax te^le, n represents an integer bet«treen and 

7$ R is a register expression; £ represents any expression; £R 
represents either a register expression or an absolute expression in 
the range of to 7. 



Address 

Mode Address 

Homber Mode Name 

On Register 



In Deferred Register 



2n Autoincrement 



Deferred 

3n Autoincrement 



4n Autodecrement 



Deferred 
5n Autodecrement 



Index by the 

Register 
fin Specified 



Syadsol in 
operand 

Field 

R 



Meaning 

Register R contains the operand. 

R is a register expression. 



8R or (Rj Register R contains the operand 
address . 

(ER)+ The contents of the register 
specified by ER are incremented 
after feeing used as the address 
of the operand » 



i(ER)+ ER contains a pointer to the 
address of the operand. ER is 
incremented after use. 

-{BR) Vh« contents of register ER are 

decremented before being used as 
the address of the operand. 



t-CEH) We contents of register BR are 

decremented before being used as 
a |x>inter to ttm address of the 
operand. 



E(ER) The value obtained when E is 
combined with the contents of 
the register specified CER) is 
the address of the operand. 
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Address Symbol in 

Mode Address Operand 

Number Mode Name Field 

Deferred index 
by the Register 

7n Specified @E(ER) 



27 Immediate Operand #E 

37 Absolute address @«B 

67 Relative address E 

77 Deferred relative 

address @B 



Meaning 

E added to EK produces a pointer 
to the address of the operand. 

E is the operand. 

E is the operand address. 

E is the address of the operand. 



E is a pointer to the address of 
the operand. 



B.3 INSTRUCTIONS 

The tables of instructions which follow are grouped according to the 
operands they teike and according to the bit patterns of their 
op- codes. 

In the representation of op-codes, the following synbols are used: 



SS 



DD 



XX 



Source operand 



Destination 
operand 

8-bit offset to a 
location 

Integer between 
and 7 



Specified by a 6-bit 
address mode 

Specified by a 6-bit 
address mode 

Branch instructions 



Represents a general 
register 



Symbols used in the description of instruction operations are: 

SB Source effective address 
DE Destination effective address 

{ ) Contents of 
-»- Becomes 

The condition codes in the processor status word (PS) are affected by 
the instructions; these condition codes are represented as follows: 



M Negative bit: 

Z Zero bit: 

V Overflow bit: 

C Carry bit: 



Set if the result is negative 
Set if the result is zero 
Set if the result had an 

overflow 
Set if the result had a carry 



In the representation of the instruction's effect on the condition 
codes r the following symbols are used: 
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* 


Conditionally set 


- 


Not affected 





Cleared 


1 


Set 



To set conditionally means to use the instruction 'n result to 

determine the state of the code. 

Logical operators are represented by the following syinbolsji 
t Inclusive OR 
(T) Exclusive OR 

& AMD 

Used ovsr a ayrabol to represent 

the I's complement of the symbol 



B.3.1 D 


"owble Operand Instructions 




(OP hfh) 










Op-code 


Mnemonic 

MOV 
MOVE 


Stands for 

MOVe 
MOVe Byte 


Oewx. 
<SE)- 


Condition Qsdes 

ation N 2 V C 


Ol^DD 
ll^DD 


-CUE) 


• 


Ik 





- 


02SSD0 
12SSiDD 


CMP 

CMPB 


CoMPare 
CoHPare Byte 


(SE)- 


-<DE} 


n 


* 


jl 


lb 


03SSDD 
13SSDD 


BIT 

BITS 


Bit Test 

Bit Test Byte 


(SE) 


& {DE) 


* 


* 





- 


04SSDD 
14SSDD 


BIC 
BICB 


Bit Clear 

Bit Clear Byte 


tii) 


S (DE)*(I](E) 


* 


* 





_ 


05SSOD 

I5ssra> 


BIS 
BISB 


Bit Set 

Bit Set Byte 


<SB) 


1 (DE)-*(nE) 


* 


* 





- 


06SSDD 
16SSDD 


SUB 


ADD 
SUBtract 


(SE) 

(ra:) 


+ CnE)-*-(DE) 

- (SB)-*(DE) 


ft 
* 


* 


* 
* 


* 
* 



B,3.2 Single Operand Instructions 



Op- code Mnemonic Stands for 



OOSOIDD 
I050DD 

0051DD 
1051DD 



CLR 



CLeaR 
CLeaR Byte 



(OP A) 

Operation 
0-f (DE) 



COM COMplement {IX)-+{DE) 

COMB CO»^lement Bytx 



Condition Codes 
H Z V C 



1 
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Op- code 


Mnemonic 

INC 
INCB 


Staunds for 

increment 
INCrement Byte 


Oper 
(DE) 


C 
at ion 

+ l-*-(DE) 


>ndi 
N 


tion Codes 
Z V C 


0052DD 
1052DD 


« 


* 


* 


1 


0053DD 
1063DD 


DEC 
DECB 


DECrernent 
IBCreroent Byte 


{DE) 


- l-*-(DE} 


* 


# 


# 


- 


0054DD 
1054DD 


NK<3 

NEGB 


NEGate 
NEGate Byte 


(m) 


+ i-*im) 


* 


* 


* 


* 


0055DD 
1055DD 


ADC 
ADCB 


ADd Carry 

AM Carry Byte 


(DE) 


+ CC)*(DE) 


* 


# 


# 


* 


0056OD 
105 6 DD 


SBC 
SBCB 


SuBtract Carry 
SuBtract Carry 
Byte 


(DE) 


- {Cj^(DE) 


* 


* 


* 


« 


0057DD 
105 7DD 


TST 

TSTB 


TeST 
TeST Byte 


(DE) 


- 0-*(DE) 


• 


* 









B.3.3 Rotate/Shift 



0060DD 


RDR 


1061DD 


RORB 


0061DD 


ROL 


106 IDD 


ROLB 


0062DD 


ASR 


1062DD 


ASRB 


0063DD 


ASL 



1063DD ASLB 



OOOIDU 
aa03DD 



JMP 

SWAB 



Rotate Right ^t£ 



Rotate Right CI 
Byte 



n i: 



—m — 



Rotate Left ^lE 



« * * A 



# # * * 



* * * * 



Byte 



u „|3- 



■43- 



T • « # • 



Arithmetic 
Shift Right ^-^ 

Arithmetic 
Shift Right iS 
Byte 



j(-4r]_ 



* * * « 



* It * * 



i-^ L I. 



g-Q^ 



ZHII 



Arithmetic 
Shift Left 

Arithmetic 

Shift Left 
Byte 

Jump 

SMap Bytes 



E-tH 






* * * * 



• * * * 



m-a- 



DE ^(PC) 

I j ■ ■ i '■■■^ ^ ■■' 



* * a 
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The following 3 instructions are available on the PDP-11/40, 45 onlys 



006SSS MFPI Move Frcm 

Previous 
Instruction 
space 

0066DD OTPI Move To 

Previous 
Instruction 
space 

0D67DD SXT Sign eX1*end 



(SE)*(TEMP) 
(SP)-2-*-(SP) 
(TEMP]+{ (SP) 



( (SP)'j-*(TEMP) 

<SP+2-^-(SP) 

(TEMP)-^(DB) 



DE if N 
bit is clear 

-1 DB if S 
bit la aet 



- 



- 



- * 



B.3.4 Operation Instructions COP) 



Op~Code Mnemonic Stands for O peration 



000000 
000001 

000002 



000003 



000004 



000005 



Condition Codes 
M Z V C 



HALT 



WAIT 



i\X X 



000003 



lOT 



EESET 



HALT 



WAIT 



The computer stops 
all functions. 

The computer stops 
and waits for an 
interrupt. 



ReTum from The PC amd Sf are 
Interrupt popped off the SP 

3 tack I 

1 (SP))-4-{PC) 

(SP)+2-+(SP) 
C(SP))^fST} 
CSP)+2-*(SP) 



Breakpoint 

Trap 



Trap to location 
14, This is used 
to call ODT. 



Input/Output Trap to location 

Trap 20. This is used 
to call RESMON. 



RESET 



Returns all I/O 
device handlers to 
pcwer-on state. 



The following instruction is available on the PI>P-ll/40r 4S onlyj 



000006 



RTT 



BeTurn from 
Interrupt 



Same as RTI 
instruction but 
inhibits trace 
trap. 
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Trapping OP or OP E whe^ 0<!=E<»337 (octal) 



104000- 
104377 



104400- 
104777 



EMP EHulator Trap to locaticat 
Trap 30. This is used 
to call system 
programs . 

TWJ? THAP Trap to location 

34. This is Tjaed 
to call any routine 
desired by the pro- 
gramster. 



conmnton code operates 

Op-co<3« Mnernonic 



000241 


CLC 


000261 


SEC 


000252 


CLV 


000262 


SEV 


000244 


CLZ 


000264 


SEZ 


000250 


cm 


000270 


SEN 


0002S4 


CNE 


000257 


ccc 


000277 


sec 


000240 


NOP 



Stands for 
CLear CArry Bit in PS. 
SEt Carry bit. 
CLear overflow bit, 
SEt overflow bit, 
CLear Zero bit. 
SEt Zero bit. 
CLear Negative bit. 
SEt Negative bit. 
CLear Negative and Zero bits, 
CLear all Condition Codes, 
Set all Condition Codes, 
No— operation . 



1*3,5 Branch Instructions OPR E 

where -12B (decimal) <{E-. -2) /2<12? (decimal) 



Op-Code frBiemonic 



0Q04XX 
OOIOXX 
0014XX 



Stands for 



BR BRanch always 

BNE Branch if Not Equal (to zero) 
BEQ Branch if EQual {to zero) 



net if branch is 
to occur 



Z-0 

Z=l 
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Op- Code 


Mnemonic 


0020XX 


BGE 


O024XX 


BLT 


0030 XX 


BGT 


0034XX 


BLE 


lOOOXX 


BPL 


1004XX 


BMI 


10 10 XX 


BHI 


1014XX 


BIjOS 


lOIOXK 


BVC 


1024XK 


BVS 


1030XX 


BCC (or 

miB) 


1034XX 


BCS (or 
BIX}) 



Stands for 

Branch if Greater than or 
Equal {to zero) 

Branch if Less Than (zero) 

Branch if Greater Than 

(zero) 

Branch if Less than or 
Equal {to zero) 

Branch if PLus 

Branch if Minus 

Branch if Higher 

Branch if Lower or Same 

Branch if overflow Clear 

Branch if overflow Set 

Branch if Carry Clear 

(or Branch if High or Same) 

Branch if Carry Set (or 
Branch if l/)w) 



Condition to be 
met if branch is 
to occur ^^^^ 

N0 V=0 

N0 V = 1 

zi ch(i)v)-0 

zt cn(i)v}»i 

N=0 

N"l 

C0Z-O 

CI 2=1 

V=0 

^1 

c=o 

C=l 



B,3.6 SubKSUtine Call C<::raR EM, A) 

Op-code Mnemonic Stands for 

004RDD JSR JtaBp to Sub- 

routine 



Operation 

Push register on the SP stack, 
put the PC in the register: 

DE-CTEMF) A temporary 

storage register 
internal to the 
processor 

(SP)-2-»-CSP) 

(FEG)^<CSP)) 

CPC)+ia-^ilEG) M depends upon 

the address mode 

(TEI^)*(PC) 
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B.3.7 Subroutine Return 
Op-code Mnemonic Stands for 



0002OR 



RTS 



ReTurn from 
Subroutine 



Operation 

Put register contents in PC 
and pop old contents from SP 
stack into register. 



B.4 ASSEMBLER DIRECTIVES 
Mnemonic Operand Stands for 
.EOT none End Of Tape 



.EVEN 

.END 

.WORD 

.BYTE 
.ASCII 

.TITLE 
.ASECT 
.CSECT 
.LIMIT 



none 



EVEN 



E END 
(E op- 
tional) 



E, E,... WORD 
E, E,. . . (the void 
operator) 

£ f £ f a « • fi X\r£ 

/xxx. ..x/ ASCII 



NAME 



none 



none 



none 



TITLE 
ASECT 
CSECT 
LIMIT 



.GLOBL NAME, NAME,... 

GLOBaL 

,HAD50 /XXX/ RADix 50 



, LIST none 



.NLIST none 



LIST 



No LIST 



Operation 

Indicates the physical end of 
the source input medium. 

Ensures that the assembly 
location counter is even by 
adding 1 if it is odd. 

Indicates the physical and 
logical end of the program and 
optionally specifies the entry 
point (E) . 

Generates words of data. 



Generates bytes of data. 

Generates 7-bit ASCII char- 
acters for text enclosed by 

delimiters. 



Generates a name 
object module. 



for 



the 



Initiates 
section. 



the 



Initiates the 
Control section. 



Absolute 



Relocatable 



Generates two words containing 
the low and high limits <f the 
relocateible section. 

Specifies each name to be a 
global symbol. 

Generates the RADIX 50 repre- 
sentation of the ASCII 
character in delimiters. 

Enables assembly listing (if 
it was off) . 

Disables assembly listing (if 
it was on] . 
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B,4,l Conditional Directives 
jMnemonic Operand Stands for 
.IFZ E IF E-0 



.IFNZ E 



I mL Jt JmI 



, IFLE E 



• XF6 



# mL JT tJ^ii JC4I 



, IFDF NAME 



. IFNDF NAME 



, EHDC noue 



IF EjtO 



IF E<0 



IF B<»0 



IF E>0 






IF NAME 

defined 



IF NAME 
undefined 



End of 
Conditional 



O peration 

Assemble what follows up to 

the terminating ,ENDC if the 
expression E is 0. 

Asseiii>le what follows up to 
the terminating »ENDC,, if the 
expression E is not 0* 

Asseni>le what follows up to 
the terminating .ENDC,. if the 
expression E is less than 0. 

AsB«nble what follows up to 
the ^rminating .ENOC, if the 
expression E is less than or 
equal to 0, 

Assemble what follows up to 
the terminating ,ENOC, if the 
expression E is greater than 
0. 

Assend^le what follows up to 

the terminating .1N!>C, if the 
expression E is greater than 
or equal to . 

Asseidile what follows up to 
the teminating .ENDC if the 
symbol NAME is defined. 

Assemble what follows up to 
the terminating ,EKDC if the 
symbol NAME is undefined. 

Term nates the range of a 
conditional directive. 
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APPENDIX C 
COMMAND AND ERROR MESSAGE SUMMARIES 



The following summaries are provided for the user's convenience and 
are grouped in chronilogical order according to the system program to 
which they refer. As these are only summaries, the user is referred 
to the appropriate chapter for details. 



C.l KEYBOARD MONITOR (Chapter 3) 



Conriand Summary * 
Command 
DATE 

DIRECTORY 
DIRECTORY/F 

LOAD 

LOAD/G 

LOAD/0 

RUN 



Explanation 

Allows the user to enter the day, month, and 
year. This date is then represented in 
directory listings. 

Causes a directory listing of the cassette 
specified in the command line. 

Causes a "fast" directory listing by omitting 
current and creation dates and listing only 
filenames and extensions. 



Instructs the Monitor to load 
specified in the command line. 



the 



file 



Instructs the Monitor to load and start 
file specified in the command line. 



the 



Instructs the Monitor to load the file 
Si^GCified in the command line, overlaying the 
Monitor as necessary. 

Instructs the Monitor to load and execute the 
file specified in the command line. 



*Qnly those characters underlined need be entered. 
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KEVBOAHn MONITOR (Cont. ) 



Cormand 



SENTINEL 



Causes a sentinel file to be written 
immediately foll<n-flng the file specified in 
the comnand line. 



START nnnnn 



VERSION 



Instructs the Monitor to begin execution of a 
loaded file at the syiecified (nnnnn) address, 

or at the transfer address if nnnnn is not 
indicated. 

Causes the version nuinlr>er of the Monitor 
currently in use to be printed on the console 

teminal. 



ZERO 



Causes deletion of all files on the cassette; 
a sentinel file is written at the beginning 



of the cassette. 



Error Message Summary 

Monitor error messages are precseded by one of two symbols indicating 
the type of error which occurred: 

7 Hon-fatal error; execution continues if possible, 

otherwise control returns to the CSI after the 
message is printed, 

1 Fatal error? control returns to the KBL after the 

iTKSsaga is printed. 



Message 
lOT 
NO FII^! OPEN 



Art j Meaning 

PC Illegal lOT 

dri^j-e # READ or WRITE with no 
SI:EK or ENTKR 



Source 
RESWON 
RESMON 



OFFLINE 



TIMING 



drive # Cassette not moxunted; if RESMON 
non- fatal, execution is 
automatically resumed 
when the cassette is mounted 
(if the user inproperly mounts 
the cassette, a fatal error 
will probably occur) 

drive # fiystem softv;are did not RESMON 
service an initiated 
request fast enough 



C~2 



KEYBOARD MONITOR (Cont,) 



Message 



TRW 




Meaning 

Stack overflow, reference 
to non-existent memory, 
illegal or reserved 
instruction^ attempt to 
reference a word on a 
byte boundary; the SP at 
the tir« of the trap is 
stored in location 44 



Source 



RESHON 



FILK NOT FND 

ILI. CMD 

NO SENTINEL FILE 



SYNTAX ERROR 



BAD TAPE 



NO BThM ADDR 



PROG TOO BIG 



SPTWR CHKSM ERF 



TRUNCATED FILE 



drive # Cassette, write- lockedi if 

non-fatal, execution is 
autonatically resumed when 
the cassette is wrlte-enabled 

Specified file not found 

Illegal conmand 

No sentinel file is 
present on the tape; 
this message occurs during 
use of the DIRECTORY 
conricind at that point during 
the directory listing where 
the sentinel file is missing 

Arguments following a 
coFimand are illegal 

Hardware checksian error 
(note that this <error 
may also be caused by 
READ operations initiated 
on a cassette which is 
positioned after the 
sentinel file) 

Loaded progratrs had no 
transfer address 

Program too big for the 
memory limits defined by 
the type of load used 

Software checksum error 
(message followed by number 
of errors } 

File ends before transfer 
address load block is 
found 



KBSKON 
KB!L 



KBL 



CLODll 



CLODll 
CLODll 



^MT JkAJ !>/ JL X 



\.jrmui^jr kjf JLt JLt 
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KEYBOARD MONITOK (Cont.) 



Message 


Arg 


Meaning 


CSI TABLE 

OWRFLOW 




Command 

for the 


string too big 
table 


ILLEGAL CHAR: 


line) 


Illegal 

copinand 


character in 
string 


ILLEGAL DEVICE J 


(CS. 

lltte) 


Illegal 


device specif icat: 


ILLEGAL SmThXs 


{C.S. 
line) 


Illegal 
string 


syntax in command 



Source 



CSI 



CSI 



CSI 



CSI 



C.S EDITOR {Chapter 4) 



Comnand Summary 

Input and Output Comxn2inds 

Conmand Form 



WRITE 



NEXT 



EDIT IffiAD EK#filnain,ext$ 

EDIT WRITE EK#filnaFi,ext$ 

READ H 



nw 

-nw 

ow 

K 

nU 



LIST 


nL 




-nL 




OL 




L 


VERIFY 


V 



i'-teaning 

Open a file for input, 

C^sen a file for output. 

Read a page of text from the 
input file and append it to 
the contents of the buffer* 

Output a specified nuHibar of 
lines of text from the Text 
Buffer to the output file. 



Output the contents of the 
Text Buffer to the output 
file, clear the buffer, and 
read in the next page of the 
input file* 

Print a specified nrniber of 
lines on the console ter- 
minal. 



Print the current text line 
(the line containing the 
pointer) on the console 
terminal. 
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EDITOR (Cont.) 



Cawmand 
END FILE 

EXIT 



Form 



EF 



EX 



Meaning 

Close the current output 
file without performing any 
further input/output 
operatione. 

Output the remainder of the 
input file to the output 
file and return control to 
the Monitor. 



Pointer Relocation 


Commeinds 


Command. 




Foxm 


BEGINNING 


E 




JUMP 


nJ 

-nJ 

OJ 

J 




ADVANCE 


nA 

-nA 

OA 

A 




Search Commands 






CoiPTOand. 




Form 


GET 


nGtext? 



FIND 



nPtext$ 



Meaning 

Move the current location 
pointer to the beginning of 
the 11ns* 

liove the pointer over a 

specified nuirt^er of char- 
acters in the Text Buffer. 



Move tJie pointer over a 
specifiad number of lines 

in the Text Buffer, The 
pointer is positioned at the 
beginning of the line. 



Meaning 

Search the contents of the 
Text Buffer, beginning at 
the current location 
pointer , for the next 
occurrence of the text 
string. 

Beginning at the current 
location pointer, search the 
entire text file for the nth 
occurrence of the specified 
character string. Pages of 
text are input, searched, 
and then output to the 
output file until the text 
string is found. 






EDITOR jCont.) 



CoPHnand 



POSITION 



Form 



nPtextS 



Meaning 

Search the input file for 
the nth occurrence of the 
text string I if the text 
string is not found, the 
buffer is cleared and a new 
page is read from the input 
file. 



Text Modification Conmands 

Command Form 

INkSERT Itext$ 



DELETE 


nD 

-nD 
OD 

D 


Kill. 


nK 
-nK 
OK 
K 


CHAMGE 


nC 

-nC 
OC 

c 


EXCHMfiE 


nXtext$ 
-nXtext? 
OXtextS 
Xtext? 


lity Coiranands 




Corroand 


Fom 



SAVE 



OHSAVE 



nS 



Meaninej 

Insert text imraediately 
following the current 
location pointer; an ALTMODE 
teri".inates the text. 

Remove a specified nuraber 
of characters from the 
Text Buffer, beginning at 

the current location 
pointer. 

Remove n lines from the Text 
Buffer, beginning at the 
current location pointer. 



Replace n characters , be- 
ginning at the pointer, with 
the indicated text string. 



Replace n lines , beginning 
at the pointer, with the 
indicated text string. 



Meaning 

Copy the specified number of 
lines , beginning at ths 
pointer, into the Sava 
Buffer, 

Insert the entire contents 
of tli^ Save Buffer into the 
Text Buffer at the position 
of the current location 
pointer. 
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CoriFiariid 



MACHO 



Form 



OU 



M/cQininand string/ 



OM 



E3S:CUTE MACRO nEM 



Meaning 

Clear the Save Buffer and 
reclaim the area for text. 



Insert a command string into 
EDIT's Macro Buffer 

Clear the Macro Buffer and 
reclaim tte area for text. 

Execute the command string 
specified in the last macro 

cononand. 



Error Message Syirtirtary 

Message 

?"<>" ERR? 

• CB ALMOST FULL • 



?CB FULL? 

?*E0r*7 

7*FTIM NOO* FOUND*? 

7*HDW ERR*? 
?ILL ARG? 



?ILL CMD? 



7ILL MAC? 



Exnlanation 

Too deep nesting, or illegal use of 
brackets, or unmatched brackets. 

The coPBnand currently being entered by 
the user is within 10 characters of 
exceeding the space availctble in the 

Command Buffer. 



Command exceeds the space allowed for 
coFimand string in the Command Buffer. 



a 



Attempted a Read or Next cammand and no 
data was available. 

Attempted to open a nonexisting file for 
editing, 

A harfivmre error occurred during I/O, 

"She argument specified was illegal for 
the coii\nand used, a negative argument 

was specified where only a positive 
argument was allw-red, or an argument 
exceeded the range + or -16384. 

EDIT does not recognize the command 
specified. 

Delimiters were improperly used, or an 
attempt was made to enter an M oarmand 
during execution of a Macro, or an 
attempt wag made to execute an EM 
connand while an EH was already in 
progress. 
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Jtessage 



EKplanatjon 



?*ILL NAME*? 



The filename or device specified in an 
EW or ER coTCraand la illegal. 



?*I/0 CHAN CONFLICT*? An attempt was macte to open an input 

file on a cassette already open for 
output, or vice versa. 



?*N0 FlIM*? 



?*N0 HOOM*? 



?*SRCH FAIL*? 



?*TAFE FULL*? 



An attempt was made to Read or Write 
when no file was open. 

An attempt was made to execute an 
Insert, Save, tlnsave. Read, ftext. 
Change, or Exchange coimaand when there 
was not enough room in the appropriate 
buffer. 

The text string specified in a Geti. Find 
or Position comrnand was not found in the 
available data. 

Available space for an output file is 
full (i.e., there is no room for any 
part of the file). 



C,3 ASSEMBLER (Chapter 5) 



Language Surnraajry 



Reference may be made to Appendix B for the CAPS-11 PMi assemblir 

languages surmary. 



Option SuniTiary 
Option 
/€ 

/F 



Meaning 

This option alleys an I/O specification 
to be broken into several segments. 



line 



This option is valid only after an input 
filename and specifies that the Assembler 
should not perform a W'WIND opsration but 
should continue searching the cassette in a 
foCTsrard direction for the file. 
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ASSEMBLER (Cont.) 



Option Meaning 

/O This option is valid only after an output 

filenane and indicates that the file 
timnediately preceding the option) is to be 
created and used only if a previously opened 
output file has been written to the end of 
the cassette and more output remains. 

/P This option is used whenever a file 

referenced in the I/O specification line 
exists on a cassette which is not currently 
mounted on a drive. Before attempting to 
search for the file, the Assembler instructs 
the user to mount the proper cassette on the 
drive by printing #? where # represents the 
drive number. After the user has switched 
cassettes on the drive, he may continue 
execution by typing any character on the 
keyboard. 

/X This option is valid only after an output 

filename and causes extended binary output 
(i.e., those locations and binary contents 
beyond the first binary word per source 
statement) to be suppressed from the listing. 



Error Message Summary 

Error Code Explanation 

A Addressing error. An address within the 

instruction is incorrect; may also 
indicate a relocation error. 

B Bounding error. Instructions or v;ord 

memory data are being assembled at an 
odd address in memory. The location 
counter is updated by +1. 

D Doubly-defined syml)ol referenced. 

Reference was made to a symbol which is 
defined more than once. 

I Illegal character detected. Illegal 

characters which are also non-printing 
are replaced by a ? on the listing. 

L Line buffer overflow. Extra characters 

on a line (more then 72 (decimal)) are 

ignored. 
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Error Code 



H 



Explanation 

Ilultiple definition of a label. A label 
va^ encountered which was equivalent (in 
the first six characters) to a 
previously encoimtered label. 

Numiaer containing 8 or ft has decimal 
point missing. The number is assexrf^led 
as a decimal nwriber. 

Phase error, A label's dafinition or 
value varies from one pass to another. 



Q 



Questional) le syntax. Missing arguments, 
the instruction scan was not completed, 
or a carriage return was not immediately 
followed by a line feed or form feed. 



R 



Re<jister-type error. An invalid use of 
or reference to a register has been 
made. 



Symliol table overflow. when the 
quantity of user-defined symbols exceeds 
the allocated space available in the 
symbol table, the Assembler outputs the 
current source line with the S error 
codSji then returns to the initial 
dialogue. 

Truncation error. J^ number generated 
more than 16 bits of significance^ or an 
expression generated more than 8 bits of 
significance during the use of the .BYTE 
directive. 



U 



Undefined ayiAsol, An undefined symbol 
was encountered during the evaluation of 
an expression, Relative to the 
expression, the undefined symbol is 
assigned a value of zero. 



In addition to the error codes listed above, the following messages 
may also occur (error messages which are followed by a question mark 
allow the user to type a CTRL/C to return to the KBL, or a CTRL/P to 
retry the operation) t 
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ASSEMBLER (Confe.) 



Message 



BAD CMu STRING 



Meaning 
One of the followxnff errcrs has 



occurred 
string: 



in the user ' s command 



No output was specified; 

No input was sj>eGifiedj 

Input and output were specified 

on the same drive? 

Input was specified frcsn a device 

other than cassette? 

Binary output was specified to a 

device other than cassette. 



?Bjy> TAPE? 



A checksum or other hard error 
occurred during a file lookup or 
enter ccHnmand. "Pyping any 

character will caisse tJhe Aaseinbler 
to retry the operation* 



IBM) TAPE 



EOM? 



A hard read error was detected on 
one of the input files ? typing any 
character (other than +C) will 
cause the Assembler to retry the 
same assenibly (in systsina larger 
than 8K, the Asseinbler %rill return 
to the CSI and allow the user to 
input a new command) . 

The line printer is out of paper or 
is not powered up; the drum gate is 
open; or the printer is too hot. 



EOM? 

RETRY? 



The end of the tape was reached 
during cassette output and no 
overflow file was specified. The 
user may mount another cassette and 
then type any keyboard character to 
instruct the Assembler to retry the 
assenihly using the new output 
cassette. 



?FII,E NOT FND? 



The ftsseii^ler could not find one of 
the input files. The user may 
mount another cassette and type any 
character on the keyboard to 
instruct the Assembler to retry the 
lookup on the same drive. Typing a 
CTRL/P will restart the Assembler 
(if the system is greater than 8K) . 
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Message 



?N0 END STMT 



Ifeaning 

The file does not contain an .END 
directive; the Assembler assumes an 
.END statement. 



PSWITCH ERRORi'x'? 



?TAPE FULL? 



An undefined option character (x) 
was found in the command string. 
Typing any character on the 
keyboard will cause the Assembler 
to ignore the option and continue. 

The specified output cassette is 
completely full. Mounting a 
different cassette on the same unit 
and typing any character instructs 
the Assembler to attempt to open 
the file on a new cassette. 



C.4 LINKER (Chapter 6) 



Option Smnnary 
Option 
/C 

/F 



Meaning 

This option allows the I/O specification 
line to be broken into several segments. 

This option is valid only after an input 
filename and indicates that the Linker 
should not perform a REWIND operation 
but should continue searching the 
cassette in a for^vard direction for the 
file. 



/o 



/p 



This option is valid only after an 
output filename and indicates that the 
file (immediately preceding the option) 
is to be created and used only if a 
previously opened output file has been 
written to the end of a cassette and 
more output remains. 

This option is used whenever a file 
referenced in an I/O specification line 
is on a cassette which is not currently 
mounted on the unit drive. Before 
attempting to search for the file, the 
Linker instructs the user to mount the 
proper cassette on the drive by printing 
#? where # represents the drive number. 
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Option 



/S 



/T 



/B:n 



/H:n 



Meaning 

After the user has switched cassettes on 
the drive, he may continue execution by 
typing any character on the keyboard. 

this option is valid only after an input 
fiienaine and indicates that two or more 
object modules have been coi»»bined (using 
PIP) under the single filenaree. The 
option instructs the Linker not to skip 
to the next input filenanse until it has 
obtained all necessary information for 
the files included in the first. 

The /T option is valid only after an 
input filename and indicates that the 

transfer address of this particular 
object module is to be used as the 
transfer address of the final load 
nodule. If more than one /T option is 
indicated in the I/O specification line^ 
only the last one is significant. 

The program is to be linked with its 
lowest location at n. If n is not 
specified, the Linker assumes location 
600. 

The program is to be linked with its 
highest location at n. If n is not 
specified, the Linker assumes that the 
last location of the user program will 
go just under CLODllj the user can then 
use the LOAD/G copiraand to run his file. 



Error Message Summary 
Non-Patal Errors 



ffessage 



7BAD TAPE? 



Meaning 

A Checksum or other hard error 
occurred during a file XXJOKUF or 
ETfTER coMinand. Typing any keyboard 
character instructs the Linker to 
retry the operation. 
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Mess 



S2£. 



?BYTE RELOC ERROR AT 
ABS ADDRESS XHXXKK 



?FILE NOT FND? 



?MRP DEVICE EOM? 



Meaning 



This message designates a b^te 
relocation error. The Linker has 
tried and failed to relocate and 
link byte quantities? the value is 
truncated to fl bits, the irsssage is 
printed, and the Linker 
automatically continues. 

The Linker could not find one of 
the input files. Typing any 
keyboard character instructs the 
Linker to retry the operation. 

The Load Map device EOM error 
allows the user an option to fix 
the device and continue by typing 
any response terrAnated by a <CH> 
or <LP> , or to abort the map 
listing by typing a tP. 



?MODULE NAME xxxxxx NOT 
UNIQUE 



?SWITCH ERROR; '!t'? 



This error results from a 
non-unique object module name 
during Pass 1, The module is 
rejected and the Linker will then 
ask for more input. 

An undefined option character was 
found in the oewmand string. 
Typing any character instructs the 
Linker to ignore the character and 
continue. 



?TAPE FULL? 



Tlie specified output cassette is 
full. A different cassette may be 
mounted on the same drive; typing 
any keyboard character then 
instructs the Linker to attempt to 
open the file on the new cassette. 



?xjcxxxx MULTIPLY DEFINED 

BY MODUUf; xxxxxx This message results during Pass 1 

if globals have been defined more 
than once. The second definition 
is ignored and the Linker 
continues . 
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Fatal Errors 



%BAD CMD STRING 






%CAS. CHECKSUM 



%ODD hmmsB 



One of the following occurred in 
the corijnand string: no output or no 
input specification; input and 
output were sijecified on the same 
drive; input was specified from a 
device other than cassette; binary 
output was specified to a device 
other than cassette. 

A chocks um error occurred ^diile 
reading a cassette block, 

An odd address was sfx*ctfied using 
the /B or /H options. 



MODULE xxxJDCX, SYMBOL 

w w* w 



A syrrfjol 
occurred. 



table overflow has 



%SYSTEM ERROR xx 



A systen error has occurred where 
XX represents an identifying number 
from the follovring lists 



01 Un re cogni zed 
entry found. 



symbol 



table 



2 A relocation directory 
references a global name which 
cannot be found in the symbol 
table, 

Q3 A relocation dlreetoi^ 
contains a location counter 
modification ooramand which Is 
not last. 

04 Object module does not start 
with a GBD, 

05 The first entry in the GfiD is 
not the module name. 

06 A relocation directory 

references a section name 
which cannot be found. 

07 The transfer address 
specification references a 
nonexistent module nane. 
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Message 



Meaning 

8 The transfer atldresa 
specification references a 
nonexistent, section name, 

09 An internal junp table index 
in out of range. 

10 A checkstm error occurred on 
the object mcxlule. 

11 An object module binary block 
is too big (more than 
64 (decimal) words of dataj . 

12 A device error occurred on the 
load module output device. 

All system errors except numiier 12 indicate a progran failure either 
in tlie Linker or the progran which generated the object module. Error 
05 can occur if a file is read which is not an object nodule. 



C.5 ODT (Chapter 7) 



Command Kumnary 


Conunand 


r/ 


/ 


r\(r.HIFT/L) 


\ 



nR 



nl 



Me an ing 

Open the word at location r. 

Reopen the last opened location. 

Open the byte at location r, 

Reopen the last opened byte. 

After a word has been opened, retype the 
contents of the word relative to 
relocation register n. If n is omitted, 
ODT selects the relocation register 
whose contents are closest but less than 
or equal to the contents of the opened 
location. 

After a word or byte has been opened, 
print the address of the opened location 
relative to relocation register n. If n 
is omitted, ODT selects the relocation 
register whose contents are closest, but 
less than or equal to the address of the 
opened location. 
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ODT (Cont.) 



Command 



\ (LINE FEED 
key) 



tor 



RETURN 



Meaning 



Open next sequential location. 

Open previous location, (The 

circumflex, " , appears on some 

keyboards and prints in place of the 
up-arrow. ) 

Close open location and accept the next 
command. 



-•-or _ 



Take contents of opened location, 
indexed by contents of PC, and open that 

location. (The underline, , appears 

on some keyboards and prints in place of 
the back- arrow. 



r;0 
Sn/ 



Take contents of opened location as 
absolute address and open that location. 

Take contents of opened location n as 
relative branch instruction and open 
referenced location. 

Return to sequence prior to last @, ■* , 
or -^ command and open succeeding 
location. 

Perform a Radix 50 unpack of the binary 
contents of the current opened word; 
then permit the storage of a new Radix 
50 binary number in the same location. 

Calculate offset from currently open 
location to r. 

Open general register n (0-7). 

Open special register Y, where Y may be 
one of the following letters; 

S Status register (saved by 
ODT after a breakpoint) 



M Mask register 

B First word of 
breakpoint table 

P Priority register 



the 



C-17 



ODT ( Cont . ) 

Conipiand Meaning 

C Constant register 

R First relocation register 
(register 0) 

F Format register 

jF Fill itKinory words with ttie contents of 

tiie constant register, 

}1 Fill memory bytes with the contents of 

the low- order 8 bits of the conatartt 
register, 

J Separate comnands fron coninand arguments 

(used with alphabetic commands below); 
separate a relocation register specifier 
from an addend. 

;B Remove all Breakpoints. 

r;B Set Breakpoint at location r. 

rjnB Set Breakpoint n at location r, 

inB Remove nth Breakpoint. 

r;B Search for instructions that reference 

effective address r. 

rjW Search for Words with bit patterns which 

match r, 

jnS Enabte single-instruction mode (n can 

have any value and is not significant) ; 
disable breakpoints, 

fS Disable single-instruction mode; 

reenahle breakpoints , 

xjG Go to location n and start pixsgram nxn. 

jP Proceed with program execution from 

breakpoint? stop when next breakpoint is 
encountered or at end of program. 

In single-instruction node only, proceed 
to execute next instruction only. 

k;P Proceed with program execution from 

breakpoint; stop after encountering the 
breakpoint k times . 
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Conunand 

J nK. 
r;nR 

TfnA 
CTRL/C 



yteaning 

In single- instruction mod® only, proceed 
to execute next k instructions. 

Set all relocation registers to -1 
(highest address value)* 

Set relocation register n to -1. 

Set relocation register ri to the value 
of r. If n is onittedj it is assumed to 

be 0. 

Print the value of r and store it in the 
constant register. 

Print n bytes in their ASCII format 
starting at location r; then allow n 

bytes to be typed, starting at location 

Return to Monitor and accept a comrnand 
from the keyboard. 



Error Ifessage Sunmary 

Ho error nKssages occur under OOT as illegal conpiands are ignored? ODT 
prints ? and the user raay anter another coFunaneJ, 



C,6 PIP (Chapter 8) 



Option Summary 
Option 
/A 

/C 



Meaning 

Used with an output filename to designa^ 
tiiat the header bit be set to ASCII (the file 
type is otherwise assumed to be binary) . 

Allo^ra the coimnand string to be broken into 
one or more lines. 

Causes the filenciiTie(s) indicated in the 
command line to be deleted from the specified 

cassette . 
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Option 
/P 



/Z 



f-teanlng 

Itequests that the si?steini prompt the user to 
change cassettes on the indicated drive 
before an attempt is made to access the file. 

The system prints: 

#? 

where # represents the number of the 
appropriate drive. When the user has mounted 
the proper cassette ^ he may type any 
character on the keyboard to continue 

execution. 

Indicates that all cassettes on the «nit 
drives specified in the comnand line are to 

be zeroed. 



Error Message Supmary 

Message 

?BAD TAPE 
?BAD TAPE? 



?EOM 



7EXCESS INPOT FILES 



?KXCESS OUTPUT PILES 



» * JL it/jr> klVj in J7 ih( t' ♦ 



Me aning 



Hardware checksun error (may also be 
caused by READ operations initiated on 
a cassette which is positioned after 
the sentinel file) ; a question mark 
following the irtessage indicates that 
the error is not fatal; the user may 
mount another cassette and type any 
character on the keyboard to continue 
execution. 

Indicates an out-of-paper condition 
for the line printer, console 
terminal, or paper tape punch. 

The nuitdser of input files exceeds the 
numl>er of output files (providing the 
nunber of output files is greater than 
one) J this error occurs during use of 
the jfile transfer function. 

The number of output files exceeds the 
nuraber of input files; this error 
occurs during use of the file transfer 
function. 

The specified file was not found on 

the cassette indicated! the user may 

mount another cassette and type any 

character on the keyboard to continue 

the search. 






Fip (Cont.) 



Message 






ffeaning 

An illegal device was 
the PIP function used. 



indicated for 



?ILLEGAL INPUT LIST 



?lIiLE(3a. OUTPUT LIST 



An input list was indicated where not 
allowed (as when using the zero, 
delete , and copy functions ) , or an 
illegal command was entered. 

An output list was indicated where not 
allowed (as when using the copy 
function) . 



?I/0 CHAM CCKPLICC 



?nQ FILE MA«E 



?OFPLINE X 



?SWITCH ERROR 'x*? 



An attCTKpt was made to open an input 
file on a cassette already open for 
output, or vice ^rersa, 

A filenaroe was not indicated in a 
«>nii!iand line which required one. 

The cassette is not properly mounted 
on drive x. The user should correctly 
mount the cassette so that executicm 
can continue. 

An illegal switch was indicated in the 
command line, where 'x* represents the 
switch in error. The check is sade 
for as many as 10 illegal switches in 
any one command line. Typing any 
character on the keyboard will cause 
PIP to ignore the switch and continue 
execution. 



?TAPE FOLL 
?TAPE FULL? 



?MRT LOCK X 



Available space for an otitput file is 
full. A question mark following the 
inessage indicates that the error is 
not fatal; the user may mount another 
cassette and type any character on the 
keyboard to continue execution. 

The cassette is write-locJted; x 
represents the drive number. The user 
should dismount the cassette {the 
OFFLINE error message will then be 
printed), write-enable the cassette ^ 
and remount it. Execution will then 
continue. 
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C.7 RESMON {Chapter 9) 



Error Message Sumnary 



RESHON error messages are sumnarized in Section C.l under the Keylsoard 
Monitor error message summary. 
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APPENDIX D 
SYSTEM DEMONSTRATION 



The folloi^ing is a brief demonstration of the CAPS- 11 system software. 
Before proceeding with this demonstration, the user should read the 
rest of the CAPS-11 manual and become familiar with the CAPS-11 system 
programs smd conventions. He should pay particular attention to the 
second half of ;^pendix E, which describes reconfiguring the CAPS-11 
Monitor for non-standard I/O devices and different memory 
configurations. In particular, if the user's system contains a 
non-standard console terminal (either I,T33 or LT35, parallel LA30 
OECwriter, or VT05 display) , he should use his reconfigured System 
Cassette for this demonstration. 

Before starting « the user should have ready the proper CAPS-11 System: 
Cassette and two scratch cassettes. The first step of the 
^monstration is to copy the System Cassette, The demonstration 
should then be continued using this newly created copy. 

In general, the user should always keep at least one ^od copy of the 
System Cassette in a safe place in the event that he should accidently 
ffestroy his *working copy'. Note that this demonstration uses the 
System Cassette when it is write-enabled, l!h.e purpose is to simplify 
the demonstration J under normal operation, the user should always use 
the System Cassette write -locked. 

Please read through the entire system demonstration before attempting 
to enter any of the command lines. 



D.l SySTEH STAKT-UP 

Write-lock the CAPS-11 System cassette by setting the hinged red tabs 
so that they are pointed toward the center of the cassette ^ exposing 
the write-protect holes; mount the cassette on drive (the drive to 
the left of the unit) . Bootstrap the CAPS-11 Monitor into memory 
using the procedure described In Chapter 3, Section 3.1. When loaded, 
the Monitor will type an identification line and a dot at the left 
margin of the coniBole terminal page (subsequent loads will cause only 
the dot to be printed) j 






CAPS-n V01-02 



If this does not occur, check that the terminal is turned on and that 

the cassette is mounted properly and retry the bootstrap procedure. 



D,2 SYSTEM DEMONSTRATIOM 

This section denranstrates briefly how to use the CAPS- 11 system 
programs by presenting them in the context of a siiaple exercise. The 
user will copy the system Cassette^ and then edit, assemble, link^ 
load, and run a single demonstration program. In tha following 
discussion, computer output is uncferlined^ when necessary tl 
differentiate it from uRer input; a J is used to indicate typing the 
RBTO»« key and $ indicates typing the ALT MODE key. Mistakes wade 
while entering command strings may be corrected by typing the RUBOUT 
key. 

Once the CAPS~11 ftonitor has been bootstraped into memory and has 
typed a dot, enter the current date by typing a command of the forms 

_^DA a7-ALK3-73 } 

substituting the current date in place of 27-AUG-73. The Monitor 
indicates that it is ready to accept another cxjinmand by printing a dot 
at the left margin of the page, ^en this dot appears, enter the 
following cornnands 

.V } 

The Version cwmroand causes the Monitor to print out the version number 
of the Monitor in use. The Monitor should respond by printing: 

CAPS- II V01-02 
a? -AUG- 7 3 

After the user has verified that the version ha is using is the 
correct one , he should next copy the System Cassette (or his 
reconfigured System Cassette) using PIP, Mount a scratch cassette on 
unit 1^ write-enabled, and type: 

The Command String interpreter (CSI) will print an asterisk at the 
left margin of the page when it is ready to accept a coraiaand line. 
Type the following coram^md to copy the System Cassette to the scratch 
cassette on drive 1 {the command may be entered as soon as the 
asterisk is printed even though program loading may be occuring 
simultaneously} t 

*lS=0!j) 

This ccatanand causes the output cassette (on drive 1) to be iseroed, and 
then copies the entire cassette from drive to drive 1, When the 
copy function is complete, the CSI will type another asterisk. Now 
type CTRL/C to return to the CAPS~11 Monitor, which will print a dot! 
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*tC ^ 



Dismount the System Cassette on unit and put it away. From now on, 

the copy of the System Cassette just created should be used in the 

demonstration. Dismount this copy from unit 1 and mount it, 
write-enbaled, on unit 0, then types 

The Monitor will list the directory of the copy just produced—a 
typical directory will appear as follows: 



27-AUG-73 
CTLOAD SYS 05 -AUG- 7 3 



CAPS 11 


S8K 


09- 


•AUG-73 


PIP 


SRU 


09-AUG-73 


EDIT 


SLG 


09- 


■AUG- 7 3 


LINK 


SRU 


09- 


■AUG-7 3 


OOT 


SLG 


09- 


■AUG-73 


PAL 


SRU 


09- 


■AUG-7 3 


DEMO 


PAL 


09- 


.AUG-7 3 



Attach this directory listing to the System Cassette on unit 0. Now 
mount another scratch cassette on unit 1, write-enabled, and zero it 
by typing: 

iZ I: ^ 

Again, the Monitor will print a dot when ready for the next conmand. 
Type in response to this dot: 

.R PAL ^ 

This command loads and starts the CAPS-11 Assembler. When the 
Assembler is found on the System Cassette, the CSI will print an 
asterisk at the left margin of the console terminal page. When the 
asterisk appears, type the following line: 

*=DEMO J 

The command instructs the Assembler to assemble the demonstration 
program stored on unit (DEMO. PAL) auid print any errors on the 
console terminal. The following error message is printed, indicating 
that there is an illegal character in the denonstration source file 
which must be corrected before the file can be assembled properly: 
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PASS 2 

I 000026 000167- 



Ji-^P 



*Ka_ADR 



J BACK TO CAPS" 1 I MONITOR 



000000 
009001 ERRORS 

122 j) 



In 8K systfiMs, the CAPS-11 Asseinbler overlays part of the Monitor so 
tJiat the system must be re-bootstrapped after an assembly has been 
completed. The assembler signals the user that it is done and ready 
to re-bootatrap the system by typing: 

tC? 

The user shoulcl ensure that the Syst^fl Cassette is still mounted on 
unit and tJten type any character on the console keyboard— the entire 
CAPS ttonitor will be bootstrapped into meraory and will print a dot 
when it is ready for a conmand. 

If the user is running with a 12K or larger CAPS-11 Monitor, the 
assembler will not oi^rlay the Monitor? thus when the assembly of the 
demo prograjo is complete, the assemhlsr will transfer control to the 

Command String Interpreter which will print an asterisk. In this 
case, return to tlie CAPS-11 Itonitor by typing: 

Again, the Monitor will print a dot when ready for a command. 



To correct the error detected in the assembly just 
CAPS-11 Editor must b© called froir, unit 0. Types 

^R EDI T J 



performed , the 



This command loads and starts the CAPS-11 Editor. The Editor will 

print an asterisk when it is ready to accept a command, ^o-ii enter the 
following line ($ represents typing the AJjTMODE key): 

♦ Eft0s DEMOSS 

There will be a pause before the next asterisk is printed since the 
Editor is searching the System Cassette for the file DETO.PAL, When 
the asterisk appears, types 



tEWUDEMOlSS 

This command instructs the Editor to open an output file 
when another asterisk appears, type the command: 



on 



unit 1; 



This will read text into the Text Buffer from the input file, search 
the buffer for a line containing an * and leave the pointer positioned 
immediately following the *, The Editor should type: 
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jnP *KBLADR ; BACK TO CAPS- 1 1 MONITOR 

This line of text contains em error which must be corrected. Type in 
response to the asterisk: 

♦-C9SV$$ 

This deletes the *, replaces it with @ and verifies the line. The 
Editor should now type: 

J>1P gKBLADR ; BACK TO CAPS- 1 I lyiOi^JI TOR 

Close the output file by typing: 

♦ EXSS 

When control has returned to the CAPS-11 Monitor, a dot will be 
printed. Next, run the Assembler by typing: 

iR PAL ^ 

When the Assembler is found on the System Cassette, the CSI will print 
an asterisk. Type the following command to assemble the edited file, 
putting the object module on the System Cassette and printing the 
listing on the console terminal (the command may be entered as soon as 
the asterisk appears; the Assembler will be simultaneously loaded into 
memory) : 

♦ DEM01,TTi = l:DEM01^ 

If the user's system includes a line printer, 'LP': may be substituted 
for 'TT: in the above command to cause the assembly listing to be 
printed on the line printer rather than the console terminal. 

The assembler will type 'PASS 2' and then print the listing as 

follows : 

PASS 2 

CAPSll PAL V0I 08/27/73 PAGE 001 

.TITLE CAPS-11 DEMO PROGRAM 

J CAPS- 11 DEMONSTRATION PROGRAM 

i 

i DEC- 11-OTDMA-A-LA 

i COPYRIGHT 1973 DIGITAL EQUIPMENT CORPORATION 

iMAYNARD, MASSACHUSETTS 01754 

iDEC ASSUMES NO RESPONSIBILITY FOR THE USE OR 

i RELIABILITY OF ITS SOFTWARE OM EQUIPMEJVT WHICH IS 40T 

t SUPPLI ED BY DEC. 

t 

t 

.GLOBL START 
t 

; ADDRESS OF CAPS-11 KBL IS IM LOCATION 50 
i 



D-5 





000050 


KBLADH= 


:50 




000015 


CRs 15 






000018 


LF«18 




000000 


0127 06 STARTS 
000600 


MOV 


#600,%6 


000i04 


000004 


lOT 




000006 


001 


.BrTE 


t..0 


000007 


000 






000010 


000000 


.WORD 





000012 


000604 


I or 




000014 


004 


.BYTE 


4,2 


00001 S 


002 






000016 


000032' 


.WORD 


MS6BUF 


000020 


000004 ^At Ts 


lOT 




000022 


003 


.BYTE 


3,8 


000023 


002 






000024 


000020' 


.WCH^D 


WAIT 


000026 


000177* 
000050 


JMP 


eKBLADR 


000032 


000100 MSQ8UFI 


.WORD 


100 


000034 


000 


.BYTE 


0<0 


000035 


000 






000036 


0000S4 


.iilORO 


MSGEMD-^SGBUF 


000040 


0IS 


.BYTE 


CRjLF 


000041 


012 






00004S 


103 


-ASCII 


/CAPS- 1 1 OEM^I 


000043 


101 






000044 


120 






00004S 


123 






000046 


ass 






000047 


061 






0000S0 


061 






000051 


040 






000052 


104 






0000S3 


10S 






0000 S4 


US 






000055 


116 






000056 


117 






000057 


123 






000060 


124 







J SET STACK POINTER 

PRESET CAPS- 1 1 

I TYPE ^^ESSACe OH CaMSOLE 
f WAl T FOR 1 T TO FI .^I SH 
t BACK TO CAPS- 1 1 nmt TOR 



JMAX.SIZE OF BUFFEI? 
IMODE IS FOWATTED ASCII 

I STATUS BYTE IS 
I BYTE COU^T 



CAPSll PAL V01 08/27/72 PAGE 



002 



00006! 


122 


000062 


101 


000063 


124 


000064 


ni 


000065 


117 


000066 


116 


000067 


040 


00007 


120 


00007 1 


122 


00007 2 


1 17 


00007 3 


107 


00007 4 


122 


00007 5 


101 


00007 6 


lis 



.ASCII /PROSRAM COMPLETE./ 
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00007 7 


040 








000108 


103 








000101 


117 








000102 


115 








000103 


120 








00010^ 


114 








000105 


105 








000106 


124 








000107 


105 








0001 10 


056 








00011 1 


015 .ay IE 


CR-LF 






000112 


012 








000113 


012 MSGEMD: .BYTE 
000000 .EiMD 


LF 
START 






CAPSll PAL V01 08/27/73 PAGE 


003 






CR = 


000015 KBLADR = 


000050 


LF 


« 000012 


MSGBUF 


000032R t^SQEND 


00011 3R 


START 


0000e0RG 


WAIT 


300020R 


000114R 






000000 ERRORS 








tC? 











Again, in 8K systems, the system must be re-bootstrapped after an 
assembly has been completed, thus the asseittbler signals the user that 
it is done and ready to re-bootatrap the systeii! by typing j 

r C? 



Ensure that the System Cassette is still mounted on unit and then 
type any character on the console keyboard to re-bcK>t the system. 

If the user is running with a IZK or larger CAPS-11 Monitor, the 
assembler will not overlay the Monitor j in this case, return to the 
CAPS- 11 Monitor by typings 



*» 



C^ 



The Monitor will print a dot when ready for a command. 

The assembler's output must be linked before it can be loaded and 
started. Run the Linker by typing i 

^R LINK^ 

When the Linker is found on the System Cassette, the C<anmand Strinrj 
Interpreter will print an asterisk. Type tha following command to 
link the assembler output file, outputting the load module (DEMO,LDA,) 
to the scratch cassette on unit X and printing a load nap on the 
console; as with the assembler, 'LP:' may be substituted for 'TTt* if 
the system contains a line printer: 
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* ltDEM0l*TT!«DEM01 /B J 

CAPS- 11 LINK V01 08/27/73 
LOAD MAP 

TRANSFER ADBRESSj 000600 
tew LiMlTf 080600 
HIGH LIMITS B007 14 

CAPS 

SECTION ADDRESS SIZE 

«, A8S.» 000000 000000 

« » 000600 000114 

START 000600 

PASS 2 

When the Linker has finished, it will tr^isfer contt^l bnck to the 
CSI , which will print an asterisk. Type CTRL/C to return control to 
the CAPS- 11 Monitor: 



** 



Cj 



Now type the following coitimand to load the demonstration program into 

niemory ! 

.LOAD 14DCM0KLDA J 

Once the program has been loaded, the >kDnitor will print a dot. Next 
run the debugging program, ODT, by typing: 

,R OOT J 

When ODT has been loaded into memory, it will type: 
ODT V01 



From the load map printed by the Linker, notice that the lowest memory 
address occupied by the program is 600 (octal). Therefore, set 
relocation register zero to 600 by typing: 

♦ 600t0R J 

next, use OOf to correct a spelling error in the output linei this 
correction is made only in inemory and not permanently in the smirce 
file, (In the foll<»?ing excsnple, data typed by ODT is undsrllnedi 
note that J indicates typing a carriage return i N lis t^ed on an LT33 
or LT3S by pressing the SHIFT and L keys simultaneously! t 

^a, SS\ li6 »N 117 J 
±B» S$\ n7 =0 116^ 

* 
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start the program using the 'Go' command in ODT; the demo program will 
type a message and then return to the CAPS-11 Monitor, which prints a 
dot: 

26001 G J 

CAPS-11 DEMONSTRATION PROGRAM COMPLETE. 
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APPENDIX E 
CAPS -11 SOFTWARE SUPPORT HflFORKATION 

E.l CAPS-11 KBYBOAttD MONITOR LOADING PHJCESS 

The CAPS-11 Pkjnitor loading process is initiated when the uaar loads 
the bootstrap loader [CBOOT) into inemory either through use of the 
hardware bootstrap or manually via the Switch Register. CBOOT calls 
the first program on the System Cassette, CTI,0AD,SYS, and frum. there, 
as far as the user is concerned, system loading is autojrtatic. A 
detailed description of this loading process follows. 

E.1.1 Cassette Bootstrap (CBOOT) 

The Cassette Bootstrap is used to load and start any program which is 

written in "CBOOT Loader Format" and is contained entirely in a 128 

(decimal) byte record; this record must be the first data record of 
the first file on a cassette. 

"CBOOT Loader Format" programs are defined to be those of length less 
than or equal to 128 (decimal) bytes which are linked so as to be 
loaded in memory beginning at location 0. A program in this format 
begins execution at its first instruction, which must be HOP 
(-000240K 

CBOOT verifies that the first byte in the program contains 240 as a 

method of detecting accidental attempts to boot a program In the wrong 
fonnat. If this occurs, or upon occurrence of any I/O error ^ CBCK3T 
halts at location CBOOT+50> at this tirae the user may examine either 
location {which will contain the first byte of the program being 
loaded) or the cassette control and status register (TACS««777500) to 
determine the cause of the error. The user may restart CBOOT by 
pjnessing the CONTinue switch on the computer console, 

CBOOT may be executed using an optional hardware bootstrap or It may 
be manually loaded by the user. Although CTOOT may be loaded anywhex«i 
in menwry (with the exception of locations 0-177) , It Is normally 
loaded at locatitm 1000, and references in this appendix will use that 
address • 
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Memory Map #1 in Figure E-3 illustrates a sap of PDP-11 memory- 
following loading of CBOOT. CBOOTP is norraally used to load PHELDR, 
which is the first record of the first file on the CAPS-11 System 
Cassette. (Listings of CWJOT and (K»OOT are provided in Figures E-4 
and E-5.) 



E.1.2 Cassette Loader (CTLOAD.SYS) 

The first file on the System Cassette is CTLOAD.SYS, which consists of 
a data record called PRELDR followed by succeeding data records making 
up the program CABLDR (which ends with a copy of CBOOT) , as follcwss 



{RECORDS) 1 




p 

I l- 



l»te.J 



dOO! 



Figure E~l CTLOAD. SVS 

As seen in Figure E-1, PRELDR is the first record of the first file on 
the System Cassette. This cassette pre-loader is actually a small 
program written in "CBOOT Loader Format" which is powerful enough to 
determine memory size and load succeeding programs into highest 
memory. It is linked, loaded, and started automatically by CBOOT at 
location 0. A map of CAPS-11 memory now appears as shi3wn in Memory 
Map 12 of Figure E-3. 

The program loaded by PREU3R may be of any size, but it must exist as 
data in 128 (decimal) byte records irsj^diately following the record 
containing PRELDR, and it must be written in "PRELDR Format". PRELDH 
format data consists of two bytes Cl<DW-order, then high-order) 
containing the byte count for the rest of the data C<"'77777} , followed 
by a memory image (i.e., data only) of the program written so as to 
begin at its first location, 

PRELDR first determines memory size, then loads this object program 
into highest memory (thus, the program must either be linked into 
highest rnemory or written in position independent code) . If an error 
(generally a hardware error) occurs during loading, PRELDR halts with 
the contents of the cassette control emd status register in Register 
4. To restart the PRELDR loading process, the user should press the 
CONTinue key cm the coropater console. 



The programs loaded by PMBLDR are CABLDR and CBOOT ^ which 
into memory as illustrated in Mentory Map #3 (Figure E-3), 



are loaded 






NOTE 

Information provided thus far asayiMS 
the user is specifically loading the 
CAPS-11 Keyboard Monitor frcsn the System 
Cassette mounted on drive 0. In order 
to allow booting from cassette drive |1 
or frcm a secondary controller, PRELDE 
assumes that Register contains the 
address of the desired controller and 
that the appropriate drive has been 
selected. This should be done manually 
by the user before booting (It is done 
automatically by CBOOT during normal 
loading) , 



The main data portion of the file CTl,OAD.SYS is CABLDR, the Cassette 
Absolute Loader. This program is used to load programs written in 
"Absolute Binary Format", which is the foncat of all system programs 
and all Linker output. Absolute binary format consists of a number of 
" load blocks ' of memory image load data with associated, header 
information; such a load block has the following general forms 



Table E-1 
Absolute Binary Load Block Format 



Byte i 


Contents 


1 
2 
3 
4 

5 

6 

« 
* 

last byte 


001 

000 
Byte Count- low order 
Byte Count-high order 
Load Address -low order 
Load Address-high order 
Memory Image Data 

« 
• 
♦ 

Checksum 



If the byte cotmt of a lo«i block is greater than 6, data is loaded 
into memory , If the byte count of a load block is equal to 6, the 

load address specified in the load block will be considered to be the 
desired transfer, or starting, address of the program? if this address 
is odd, CABLDR will halt. (It is not possible for the byte extant of a 
load block to be less than 6.) 

Immediately after being loaded into highest memory, CABIUJR is started 
and checks the contents of the Switch Register, which must have been 
previously set by the user for one of the conditions listed in Table 

E-2: 
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Table E-2 

CABLDR Switch Register Settlntjs 



Switch Register 



Action 



Bit #0=0 



Bit #0»1 and 
Bit #15«1 



Bit #0=1 and 
Bit #15-0 and 
Bits #1-141«»0 

Bit #0=1 and 
Bit #13*0 and 
Bits #l-14"n 



Nojnnal loadj use loading and starting 
addresses as specified in load blocks. 
(This is the switch setting used during 
the CAPS-11 system load, I 

Relocating load; CABLDR halts ao that 
the user can set the Switch Agister to 
the address at which the program is to 
be relocated {called the load bias? the 
program must be petition independent) . 
Bit of this Switch Register setting is 
ignored. The user begins the load by 
pressing coNTinue on the computer 
console . 

Contiguous relocating load; the program 
is loaded inanediately following the last 
byte of a previously loaded program. 

Non- contiguous relocating load? n-1 

files are skipped and the program is 
positioned before the nth filer CABLDR 
halts for further user action. 



Data will be loaded in standard cassette files with a fixed record 
size <128 bytes). GABLDH cheeks the continuation byte in the file 
header record <see the Cassette Standard in Appendix F| , and allows 
for an additional header record if this byte contains 1. ifecord siae 
is determined froin the proper header locations. 

If CABLDR halts during operation, the user may examine the contents of 
Register 4 to determine the reason for the halt as follows! 



Table E-3 
CABLDR Halts 



R4 C<attents 


Meaning 


1 
2 


File skip cjomplete; the user should reset the 
Switch Register for the next desired action 
<see Table E-2) and then press CONTinue to 
load. 

Command to relocate noted; the user should 
set the relocation address in the Switch 
Register and press CONTinue to begin the 
load. 



{Continued on next page) 
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Table E-3 {Cont.) 

CABL0R Halts 



R4 Contents 



Meaning 



Ixxxxx 



File has no fij^d record length? since CAByjR 
cannot handle this type of file, the user 
should press CONTinue to cause CRBLDK to skip 

to the nsKt £il@« 

No transfer address was found in the last 
load block? the user should set the address 
in the Switch Itegister and press CONTinue to 
fo to the next file. 

Hardware error j The contents of the cassette 
and control status register are displayed in 
Register 4. Three basic types of hardware 
errors may occur: 



Error 



Off-LinCf Write-LocJt 



Clear leader. File Gap 



Timing and Block Check 



Action 

Press CONT to retry 
function . 

Pile is not in legal 
LDA format and is 
ignored. Set the 
switch register 
(refer to Table E-2) 
to indicate which 
file to skip to, or 
insert another 
cassette, and press 

Retry functitHi 3 
times before halting 
again. Pressing 
CONTinue causes 
CABLDR to skip the 
current file and try 



Software checksum errors are noted but do not affect the loading 
process, At the termination of loading, the last location in CABLDR 

CSFTCHR) will contain the number of software checksum errors 

encountered. 



NOTE 

In order to allow booting ftmi cassette 
drive 1 or froan a secondary TAll 
controller^ CABLDR assumes (on entry) 
that iFtefister <^sntains the desired 
controller address with the appropriate 
drive selected. This is ordinarily done 
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by CBOOT, or manually by the user before 
booting. 

Once in memory, CMLDR may be started 
manually aa follows i 

1. Select appropriate drive in desired 
control and status register; 

2. Deposit that controller address 
into RO; 

3. Start CABLDJR at location x65?Q 
where x corresponds to laemory size 
as follows « 



X 


MBM^iry Size 


1 


4K 


3 


SK 


5 


12K 


7 


16K 


11 


20K 


13 


24K 


15 


2aK 



To load front drive of the cassette 
control and status register (s»777500) 
without setting up RO, start CABLDR at 
location x6572. 



E,l,3 Cassette Monitor (CM'Sll.SYSj 

In the Monitor loading process, the file loaded by CABI.DH is 
CAPSll.SYS, which is laade up of two programs, CSYSLD.JLDA. and 
C&FSlltht^f as follows t 



CS^SlO.tXJA 



CAPSn.LOA 



Figure B-2 CAPS 11. SYS 

CSYLD.LDA is loaded first by CABLDR at location 1100 (refer to Memory 
Map #4 of Figure E,3) and is simply a special version of CABLDR 
modified to load a program conaisting of 128 byte jDecaards? the load 
begins with the byte immediately following CSYSLD.LDAi this is the 
first byte of the second file comprlsiiig ClUPSll.SYS — CltPSll.LOA. Fart 
of this load overlays ttie normal CABLDR originally stored in high 
Bsemory, and part is loaded into low nramory, oirerlaying PWELM, A map 
of laemory now exis^ as showti in Memory Hap #5 {Figure £~3) . 

THie CAPS-ll System is new fully loaded into memory. 
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K»1 (Of X 


X 


M#BA6i^ 


t 


4SC 


:t 


*K 


s 


12K 


} 


teK 


u 


20K 


n 


3dK 


K 


28 K 



C BOOT 



PBEIOB 



1070 
lOOO 



too 





MEWOn M*P # 1 



mMom >*M-*t 



SSPS'l 



CSOOl 



PHiD« 



X7?I0 

X*5T0 



1070 

1000 



wo 





£_BqOT_ 



CSKUa.LOA 



CBOOT 



PSilD* 



XJ710 
XM70 



1100 
tOTO 



100 



KJO 





C BOOT 



CUPSl 1 . LD^ 



CSYStO, IDA 
C BOOT 



CAPS1I. LDA 



•X7?iO 



-[x-i] ISOO 



IC7I3 
lOOS 





M£MC^ *AP # 3 



«KM08T MA? ** 



MiMoey MAP #s 



Figure E-3 CAPS- 11 Loading Procesa 
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CAPSn PPL V0l 



PAGE 001 

.TITLE CBOOT < CAPS- 1 O V01-06 5/30/73 

PDP-H CASSETTE BOOTSTRAP 

COPYRIGHT 1973 DIGITAL EQUIPMENT CORPORATI Org> 
MAVNARD^MA. 

DEC-li-OTCgA-A-LA 

&ft p* jmsm 

C800T MILL LOAD MD SUCGESSFULUy START 

ANY PROGRAM mtCH IS WRITTEN IN 'CBOOT 

LOADER FORMAT* AND IS COi^lTAINED ENTI RELV 

IN A 128. (DECIMAL) ByTE RECORD WHICM IS THE 

FIRST DATA RECORD OF THE FIRST FILE 

OF A CASSETTE. 

CBOOT IS POSITIOf* INDEPi>l0ENT, 

TO BOOT FROM LWIT fl OR FROM SOME OTHER 
CONTROLLER* SET UP R0 WITH THE DESIRED 
COf^TRCLLER ADDRESS AMD SET THE UNIT SELECT 
BIT AS DESIRED, THBNI START THE BOOTSTRAP 
AT THE THIRD INSTRUCTION. PREi.DR AND 
CABLDR WILL USE R0 AS SET-UP AT BOOTSTRAP 
TIME TO CONTINUE LOADING FROM THE 
SELECTED UNIT. 

CBOOT DOES A REWIND* SPACES FORWARD 
A RECORD tTO SKIP O^ER HEADER OF FIRST 
FJLE># ANID STARTS READING ThIE NEXT RECORD. 
A CRC CHECK IS HADE AT TO E END OF THE RECORD. 

SIZE » £9. WOKDS 



CAPS 1 1 PAL V01 



PAGE 002 



• GLOBL CBOOT 



000000 



■CSECT 



000000 R0s%0 

000001 RI»X1 

000002 RB'stS 

000003 R39X3 
000007 PC«X7 
177500 TACS=t77500 



jTA-M CONTROL AMD STATUS REG. 



Figure E-4 CBOOf 
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000000 


012700 

177500 


caooTj 


MOV 


#TACS, R0 


000004 


005010 




(xn 


CR0> 


0&ssmt> 


01070! 


RESTftTs 


MOV 


PC»R1 


000010 


0627 01 
000052 




ADO 


#TA8LE-.,f?l 


000014 


0127 08 
00037 5 




MOV 


#375, Rg 


000i20 


112103 


i 

LOOPlt 


novB 


<Rl>*jR3 


000022 


112M0 


MOVB 


<Rl)*,tft0> 


000024 


100413 


v-**-- 


BMI 


DONE 


000026 


130310 


LOOPS J 


BITB 


R3#(R0> 


000030 


001776 




B£0 


LOOPS 


00003a 


105202 




1^JCB 


R2 


000034 


100772 




BMI 


LOOPl 


000036 


1 16012 

000002 




MOVB 


atR0)>CR2) 


00004S 


120337 
000000 




CMPB 


R3j»*0 


000046 


0017 67 




BEQ 


LOOPS 


000050 


000000 


STOP* 


HALT 




000052 


0007 55 


t 

DONE: 


BR 


RESTRT 


000054 


00S7 10 


TST 


(R0> 


000056 


100774 




BMI 


STOP 


000060 


005007 


t 

TABLE! 


CLR 


PC 


000062 


017 640 


.WORD 


17 640 


000064 


002415 




.WORD 


2415 


000066 


112024 




.«0R0 


112024 



J SELECT UNIT #0 

J USE FOR PI C 

JRI H(M-OS ADOR. OF 

J COMMAND TAaUE 
JME«ORf PTR. AND 

J DATA FLAG 
J TEST BITS 

;COM>IAND FROM TABLE 

J TO TACS. liHEN CWIii^ANO 

J CODE NEC, QUIT 

J TEST READ/ AND T-RE®» 

J BITS IN TAC5 

JLOOP 'TILL SOMETHING 

J COIES VP 

J ADVANCE HENORV PTR. 

tlF MINUS^ TRy NE^tT 

J COM01AND 

J READ DATA INTO MfEnORf 

J FIRST BfTE READ 

JSKOULD BE '240' 
JIF 0>K.jp GO READ 
I ANOTHER BYTE 
IHALT ON ERROR 
J RESTART ON CONTINUE 

JCKECK FOR ERROR 
JHi^T 0^* ERROR 

J= 'JrtP ##0* 

t .BTTE 2401 
JREADY*T-REO. 
J.BTTE 37J 
ilLBS-i-READV-i-GO 

I. BYTE 15s sre+ao 

J.BTTE Ss READ* 00 
J.SVTE 24j read* I lbs 
I. BYTE 2g4s 
t REAO-i-I L8S# E. 0. TABLE 



000001 



ewo 



Figure E-4 CBOOT (Cont,) 






CAPSIl PM. V0I 06/05/t3 PAGE 001 

.TITLE QCBOOT V0I-0S 5/20/73 

I 

I PDF- 11 QUIOC CASSETTE BOOTSTRAP 
1 

I COPYRIGHT 1973 BY DIGITAL EQUIPMENT CORP.* 
MAYNARD* MA. 
BY* ROY FOLK 

LOADS <NE RECORD UNTIL ERROR. LOADS AT B. 

DOES REWIND AND SKIPS FIRST RECORD OF FIRST FILE. 

STARTS LOADED PROGRA« AT 0. 

THE CODE IS POSITION IfstOEPEhiDENT. 

TO BOOT FROM DIFFERENT UMI T OR CONTROLLER* SET 
UP R0 AND CORRESPONDING TAGS REGISTER AS DESIRED 
MAi>*UALLY mo START AT THIRD INSTRUCTICW OF BOOT. 

SIZE = Se. WORDS 

mm»e> .csect 



000000 R£s 

000001 Rt« 

000002 R2= 
000007 PC« 
177500 TACS= 

J 



X0 

%l 

n 



177 500 *TA-!1 CONTROL AND STATUS RESISTER 



000000 0127 00 OCBOOTi MOV 

177500 

000004 005010 CLR 

000006 0107 01 MOV 

000010 0S2701 ADD 

000034 

0000M 112102 MOVB 

000016 112110 FlMCi HOVB 

000020 0327 10 LOOP! BIT 

100240 

000024 0017 7 5 BEQ 



00002 & 100001 
000030 005007 
000032 005202 GOONI 

000034 1007 7 

000036 n«012 

000002 

000042 0007 £6 



000044 017775 TAO-El .WORD 



000046 002415 .WORD 



60000 1 .END 



#TAGS* R0 

<R0) 
PCiRl 

#TABLE-.*R1 

(RI>+*R2 
CR1> + ,<R0» 
I100240«CR0> 



LOOP 



BPL 
CLR 

INC 


GOON 

PC 

R2 


mi 


FUNC 


MOVB 


2CR0>j<R25 


BR 


LOOP 



17775 



24 IS 



J SELECT UNIT #0 
JtLOAD 4EAD OF TABLE 
JINTO REG. PIC'LY 

;* 'MOV #177775#R2* 
J SELECT FUNCTI ON AND 
lao TEST ERROR, READY* 

J TREQ. 

J LOOP 'TILL SOMETHING 

I HAPPENS. ... 

J MO ERROR - GO ON 

I START PROG. ON FIRST 

J ERROR COUNTER AND 

JrtEMORY AOOR. 

100 REWIND, SFB, READJ 

ITMEN GET BYTES 

JACTUA. LOAD 

J WAIT, THEN GET MORE 
J UNTIL ERROR 

I .BYTE 37 St FOR 
IR2 COUNTER 

/.BYTE 37t 
lREWIND*lLBS+gO 
J. aim 13! isFB*QO 
I. BYTE 5j READ+aO 



Figure E*-5 QCBOOT 
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E.2 BUILDING MEMORY CONFIGURATIONS FOR THE CAPS-11 SYSTEM 

A CAPS-11 System configured for 8K is stored on the System Cassette 
included in the CAPS-11 software package. Upon first receiving the 
system, the user should read the documentation to familiarize himself 
with CAPS-11. 

If his hardware includes additional memory or a non-stand?rd terminal 
or line printer, the user will want to reconfigure his CAPS-11 system 
to take advantage of this hardware. The Linker stored on the 8K 
System Cassette is used for the reconfiguration process. In addition, 
the user should have ready two blank cassettes cmd the two OBJ 
Cassettes containing the following directories: 



OBJ Cassette #1 



OBJ Cassette #2 



CSYSLD 


LDA 


KBLRES 


OBJ 


KBL 


OBJ 


CABLDR 


OBJ 


CSI 


OBJ 


CLOD 11 


OBJ 


RESMON 


OBJ 


CBOOT 


OBJ 


LA30P 


OBJ 


VT05 


OBJ 


LP80 


OBJ 


ODT 


OBJ 


PIP 


OBJ 


CSINBF 


OBJ 


EDIT 


OBJ 



KBLRES 


OBJ 


PAL 


OBJ 


P12SYM 


OBJ 


P16SYM 


OBJ 


LINK 


OBJ 


CSITAC 


OBJ 


P8SYM 


OBJ 



Ensure that the 8K System Cassette and the two OBJ Cassettes are 
write-locked; write-enable the two blank cassettes. Mount the 8K 
System Cassette on drive and bootstrap the CAPS-11 System (refer to 
Chapter 3) . 

To reconfigure the Monitor files, the user must first consider which 
hardware options ai^e present on his system. Standard hardware devices 
include serial LA30 cmd 132-column line printer. Non-standard devices 
include parallel LA30, LT33 or LT35 Teletype, VT05 and 80-column line 
printer. If reconfiguration is necessary because of non-standard 
devices, the user will find it helpful at this point to patch the 
Monitor so that the non-standard devices (in this case, specifically 
the console terminal) can be used more efficiently during the 
reconfiguration process itself. To make the patch, follow the 
procedure listed below: 

1. After the 8K CAPS-11 Monitor has typed the version message on 
the terminal, set the ENABLE/HALT switch to HALT 

2. Set the Switch Etegister to 000056 

3. Depress LOAD ADDRESS 

4. If the console terminal is a: 

a. LT33 or LT35 Teletype or parallel LA30 , set the Switch 
Etegister to 000000? go to step 5 

b. VT05, set the Switch Register to 002012; go to step 5 
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5, Raise the DEPosit switch 

6, Set the ENABLE /HALT switch to ENABLE 

7, Depress the CONTinue key 

NOTE 

The user is advised to read through the 
remainder of this section before 
entering any of the following conanand 
lines. All cotmmand lines are terminated 
by a carriage return { i)) » 

After the patch has been made, continue with the system 

reconfiguration by mounting one of the blaiik cassettes on drive 1| 
enter the current date and zero the blartc cassette using the oormanidsi 

^OA ^d-mmn-yy J (day-wonth-year} 

Next run the BK System Linker and enter the command line and a 
carriage return as shown belowj the conmand line may be entered as 
soon as the asterisk is printed even though the Linker ia being 
simultaneously loaded into memory. 

.R LliVK^ 

* 1 1 CAPS 11 * TT: =K BL /P* CABL DR /F* CSl /F, CL OD U /F> R£S^a>J /F/C J 

Because of the /C option, the Linker will not initiate action until 
the second half of the command line is typed; see Section E.2.1, 

following. 

NOTE 

If the system includes a line printer, 
the output device specification LPi raay 
be substituted for Tfj in all command 
lines described in this section. If the 
user does not desire a listing of the 
load map, he may omit the listing output 
specification entirely from all ccsnmand 
lines. 



E,2,l Reconfiguring the Monitor 

To reconfigure the Monitor files for a standard system (i.e., one that 

includes the standard devlcea — serial LA30 and 132-coluBm line 
printer) continue the previously entered conroand line by entering ttie 

following t 
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* CBOOT/F/H: xxxxxx } 

The response for the /H qption depends upcm the size of the system to 
be reconfigured as follows: 

Table E-4 
Monitor /H Optical, Responses 



Memory Size 


XXX XXX 


12K 
16K 
20 K 
24K 
2BK {or larger) 


60000 
100000 
120000 
140000 
160000 



To allow reconfiguration for non-standard devices ^ mc^iflcations must 
be niade to the continued portion of the command line. The user should 
choose the coBBtiffirid line which corresponds to his hardware 
configuration from the descriptions which follow. 



PABALLEL LA30 OR TELE'TOPB 

If the console terminal is a parallel LA30 or t(rT33 or ItT35 Teletype, 
the second line of the command string must be entered as follows t 

,CBOOT/F*LA30P/F/HI:xxxxxxJ> 

The response for /H is taken fron Table E-4. 



PARALLEL LA30 OR TELETYPE AND 80-COLUMN LBIE PIElNTER 

If, in addition to a parallel LA30, LT33 or LT35 Teletype, the sysl^tn 
includes an 30-col«ran line printer, the second line of the consfiand 

string becomes i 

*CaOOT/r*LA30P/F,LP80/F/Hi!XXXXXX^ 
Again, the response for /H is taken from Table B-4» 



VT05 

If the console tenninal is a VT05 , the second line of the command 
string is the following: 

t CBOOT/F, VT05/F/h:xxxxxx^ 

The response for /H is taken from Table E*4, 
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VT05 AND 80-COLUJW LIIKE PRINTER 

If the system includes a VT05 and an SO-coluHUt line printer, the 
eoittaand line must be entered as foll0s»si 

*CBOOT/Fj.VT05/F,LP80/F/K!XXXSXX ^ 

The response for /H is again chosen trtm Table E-4. 

Thus, for example, if the system includes a VT05 and an 80 column line 
printer and is to be reconfigured for 16K, the entire command line 
would be entered as: 

* l!CAPSll,LPl=KaL/P>CABLDR/F*CSI /Fj. CLODl 1/F> RESMfW/r/C J^ 
TCBOOT/F*VT05/F,LPgi/F/r^: 100000;* 

When the entire conmand line has been entered followed by a carriage 

return, a prompt itiessage will occur {til) i mount OBJ Cassette #1 
^containing the files KBL.OBJ, CABLDR.OBJ, etc.) on unit and type 
aiiy character on the keyboard to continue execution, when the prewipt 
message occurs for pass 2, again respond by typing any character on 
the keyboard. After the command has been executed, control returns to 
the Linker which prints an asterisk indicating that It is re^dy to 
receive another cDitnnand, If the system includes 8K of laenKsry and the 
user is reconfiguring the Monitor only to take advantage of a 
non-Btandard device, his reconfiguration is complete and he should 
skip to Section E.2,6 to create his new System cassette. If the 
system includes more than 8K, continue the reconfiguration process as 
described b^low. 



E,2.2 Reconfiguring PAL 

Rewind OBJ Cassette #1 and then mount OBJ Cassette #2 (containing 
PAL. OBJ, etc.) on drive and enter the following! 

• 1 ! PAL. SRU, TTS =KBLRES* PAL/F/C^ 
,P12SyM/FCor P16SfN/F],CSITAC/F/Bl400 ^ 

The file P12SYH is used for reconfiguring PM. for a 12K aysteisj PlfiSfM 
is used for all systems hftjich are 16K or more. 



E.2,3 Reconfiguring LINK 

The 8K Linker contains room for approximately 225 (decimal) syiribolsi if 
the user needs more, he can next reconfigure LINK as follows j 

il:LIN<.SRU,TT!=LJ(vlK>CSITAC/F/HiXXXXXX ^ 

where xxxxxx represents one of the following* 
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Table B-5 
Linker and OUT /H t^tion ReaponaesE 



Memory Size 


X3QCXXK 


12K 
16K 

20K 
24K 

28K {or larger) 


41500 

61500 

101500 

121500 

141500 



£.2.4 Reconfiguring ODT 

Rewind OBJ Cassette #2. ODT is next reconfigured by imsunting OBJ 
Cassette #1 on unit and entering the following command line $ 

*1!0DT.SLGpTT: = KBLRES,ODT/F/H!,XXXKXX J 

The value for xxxxxx is also chosen frcm Table E-5. 



E.2.5 Reconfiguring PIP and EDIT 

There is no need to relink PiP or the Editor since these programs use 
the same amount of memory in any size system. 

The user is now ready to create the new System Cassette. 
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E,2,6 Creating a New System Cassette 
Return to the Monitor by typing: 

Rewind OBJ Cassette #1 and mount the 8K System Cassette on unit Oj 
obtain a directory listing of the cassette on unit 1 (which contains 
all the newly reconfigured files) by typings 

.Dl l: J 

When the directory has finished listing, rei^sve the cassette from unit 
1, write-protect it, and attach the dtrestory listing to it, Bie 
second blank cassette should next be mounted on unit 1 and zeroed. 
Then run PIP and type the coirmand line as shown belowi 

*llCTLOAD. SyS=CTLOAD. SyS J 

'Shm coHsnand line may be entered as soon as the asterisk appears. 
Control remains in PIP, so when this transfer is complete, mount OBJ 
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Cassette #1 (containing CSYSLD.LDA, etc.) on unit and enter the next 
coininand : 

* is CAPS 1 l.Snn=CSrSLD.LDA. CAPSJl.LOA/P ^ 

The values for nn are taken from the following list? this causes the 
file to be labeled so as to correspond with the memory size of the 
system: 



Table E-6 
Syatein Cassette Labeling Responses 



Mtepiory Size 


nn 


8K 
12K 

16 K 

2aK 

etc . . . 


8K 
12 
16 
20 



Hhen the proitipt message occurs, the user should rewind Ol&J Cassette #1 
and disittount it from unit 0; mount the cassette containing the 
reconfigured files (i.e., the new version of CAPSllj and type any 
keyboard character to continue execution. 

When PIP returns an asterisk indicating that the transfer is finished, 
the user can copy PIP and the Editor from the 8K System Cassette using 
the command; 

» U PIP. SRU, EDI T. SLG = PI P. SRU, EDI T, SLQ ) 

The remaining files comprising the CAPS- 11 system should next be 
copied to the new System Cassette using any order desired. The 

recoirtmended order of files isi 



CTLOAD 


SYS 


CAPS \ ! 


saK 


PtP 


SRU 


EDIT 


SLG 


LINK 


SRU 


OOT 


SLO 


PM- 


SRU 


DEMO 


PAL 



If the user has reconfigured LINK, ODT, or PAL, he should copy these 
programs from the cassette containing the reconfigured versions » 
Otherwise^ he should copy them from the original 8K System Cassette. 
The DEMO program on the 8K System Cassette should be the last program 
copied , 

The PIP commands to perform these transfers are as follows: 

Mount the cassette containing the proper version of LINK on unit 0, 
write -locked, and types 

ilJLINK.SRUsLINK.SRUj 
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Mount the cassette containing the proper version of ODT on unit 0, 
write- locked, and type: 

* l: ODT. SLG=ODT. SLG^ 

Mount the cassette containing the proper version of PAL on unit 0, 
write- locked, and type: 

*^l:PAL. SRU=PAL. SRU^ 

Lastly, mount the 8K System Cassette on unit 0, write-locked, and 
type: 

* 1:DEM0.PAL = DEM0. PAL ^ 

A directory listing of the new System Cassette should be obtained when 
all transfers are complete and compared to the directory listing above 
to ensure that all files are present. Several copies of this cassette 
should next be made (using the PIP copy function). 

The user is now ready to try the demonstration program in Appendix D. 
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APPENDIX P 

CfcSSKPCE STAHDARDS 



The information in this doctitE^nt is subject to 
change without notice and should not be construed 
as a cormitment by Digital Equipment Corporation. 
Digital Equipment Corporation assumes no 
responsibility for any errors that may appear in 
this document. 

The software described in this &>cuinent is 
furnished to the purchaser under a license for use 
on a single computer aystani and can be copied 
{with inclusion of i>igitI!lL*s copyright notice) 
only for use in fluch system, except as may 
otherwise be provided in writing by tilGZTMi, 

Digital Equipmant Corporation asatiraes no 
responsibility for the use or reli^llity of its 
software on equipment that is not aypplied by 
DIGITflX,. 



r' 



p-1 



F.l INTRODUCTION 

Following is a description of the format and labeling eoRventiona for 
files and records written on Digital Equipment Corporation TUSO 
cassettes and specifically for those written under the CAPS-ll ayst»». 
This standard must be followed irfien reading and writing cassettes 
intended for interchange between systems; it is recomiiended for other 
cassettes . 

The standard describes provisions for file header records which 
contain information on filename, creation date, record length and data 
format. There is room in the standard header record for twelve bytes 
of additional information which can vary froai systewi to system* Wtere 
is also provision for an extra header record if twelve bytes are not 
sufficient for additional file information* 

The subset of the standard (described in Section F,4^ details the 
minimum requirements that any cassette system should support. This 

restricted standard includes header record labels, fixed- length , 
12 8-byte records, and data. Wo support is required for 
variable-length records, imilti-volurae files, or expanded information 

in a second header record. 



P 2 DEPTH T'^XC^Q 

A cassette consists of a sequjence of one or more files, separated froia 
each other by a single file qeapm The first file on the cassette laust 
be preceded toy a file gap; the last file must be follcwed by a file 
gap and a sentinel file [refer to paragraph F, 3,31, or by clear 
trailer. 

Each file consists of a sequence of a header record plus zero or tnore 

data records separated frora each other by record gaps. The first 
record of a file is called the file header record, or file label* 

A record consists of a sequence of from one up to 2 cassette 

bytes followed by a two-byte cyclic redundancy check, (This is a 

logical limitj there is no physical limit, except for the length of 
the tape.) 

A cassette byte is eight bits* A bit is a binary zero CO) or one (1). 

A character is a byte interpreted via the ASCII character codes* 
Parity is not required and CAPS-11 ignores the high-order bit of ASCII 

data. 



F.3 THE FUIi STANDiARD 



F. 3,1 Applicability 

This standard is intended to allow full utilization of the 

capabilities of cassettes. 
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p. 3, 2 The Header Record 



THE ril^ NAME 



Each file must begin i#ith 4 32 (decimal) byte file header record. 
Figure F-1 illustrates the format of the header record, The name and 
the date are in seven-bit ASCII, 



leNGTH IN atTES [DECIMAL) 



SVTES NUMBa? 
CDeCIMAL] 



1 2 



12 



RUNAMG 
— I — 1 i ..i.....i_i ( i 






...J 




DATE LK^USEO \\ 

— 1 — 1 — i 1....1 i s t j.„ . 1 // 1 1 



1 



Tvpe 

«ECORD Lf NGTH ■ 

SEQUENCE 

CONTINUED 



10. 



15 



ao 



Figure F-l File Header Record Format 

•Hje first nine bytes of a header record contain the file's name. File 
names are divided into a six-character "name" and a three character 
"extension". File names and extensions may consist of letters, 
numerals and blanks. The first character may not be blank? there can 
be no ia&edded blanka within name or extensioni name or extension niay 
be padded on the right with blanks. 

HOTE 

When a file is deleted* the current 
syatems chan^ the name to begin with an 
asterisl^ {*f# in addition to setting the 
type bit (described next) to 14. 



THE FIIiE TYPE 

Byte nine in the header record contains the "File Type", The File 
Type defines the mode in which data was recorded in that file. Table 
F-1 lists the file type codes and gives the meanings associated with 
them CCAPS-11 uses file type codes 1, 2, and 14 >, 



z^'- 



F-3 



Table F-1 

Stamdard File Typ«s 



Type 


Description 


1 


JiSCII (seven bits per character — high-order bit 
undefined) 


2 


Paper Tape Image (non-ASCII) i one frame per byte 
(operating systaia dependent) 


3 


Core Image Porraat ll 

One 3S-bit computer word in five bytes (wastes 
low-order four bits of the fifth bybe) 


4 


Core Image Fonrat #2 

One 12-bit computer word in two bytea (only the 
low-order six bits of each byte is used) 


5 


Core Image Fonaat #3 

One 18-bit word in three bytes {wastes 
low-order six bits of the last bytxt) 


6 


Core Image Format #4 

Qae 36-bit ccmputer word in six bytes (only the 
low-order six bits of each byte ia used) 


7 


Core Image Format #5 

One 16-bit computer word in two byt^s 


XO 
11 


Core Image Format #6 (OS/8 character paclclng) 

fhi^e bytes for two 12-bit words, as shown 

below: 


(aK>8DS 1 i -I 


t t 


I — —-i , 


i 4 -^ i J 


WtIS j 1 1 1 1 


Co^ Image Format #7 

Two 36-bit words in nine bytes. 


12 


Core Iin«^e Format #8 

Four 18-bit words in nine bytes. 


i 13 


Bootstrap Pile 


14 


Bad File 



FILE Kga)»D LENGTH 

Bytes 10 and 11 of the File Header Becord contain the file record 
length (the file record length is fixed at 128 bytes per record) . 
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NOTE 

Byte 10 csontains the high-order bits. 
Thus, record length; ■" 256*cont©uts of 
byte 10 plus contents of byte 11. 



FILE SEQUENCE MIMBER 

Byte 12 contains the see[uence nmriber for multl'volume files. It is 
normally zero^ otherwise. It is used for infomiation that is split yp 
amonq files of the same name* Successive continuation files cm 
different cassettes should be nuwtoered 1, 2, 3, ,,. etc, in this 
field. {CAPS-11 does not support multivolume files,) 



HEADEE COHTINUiiTICfti BYTE 

Byte 13, when non-zero, specifies the numiber of bytes in an auxiliary 
header record, which ismediately follows this record. If it is aero, 
data begins imsediately with the next record. The format of auxiliary 
header records is not specified at this time, {CAPS-11 does not use 
auxiliary header records.) 



FILE CREAfKSi DATE 

The file creation date Is contained in the six bytes starting at byte 
m. Hhen specified, this date shall consist of six seven-bit ASCII 
digits specifying the day niunber (01-31), the month nuirfjer (01-12), 
and the last two digits of tile year nuird^r, in the order ddrnnyy. If 
not used, the first byte should be zero (null), or blank (ASC1I"40} . 



UNUSED Bfms 

■The twelve byt^s starting at byte 20 are not currently specified. 

F,3,3 Iroglcal End of Tape 

Logical end of tape is signified by clear trailer or a sentinel file. 
The sentinel file consists of a single header recoil whose file najse 
begins with a sero (null) . 



^..., 
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p. 4 THE RESTRICTED STMiDARD 



F.4.1 Applicability 



-% 



C&PS-H supports a eubaet of the cassette standard described 
previously. Features supported and not supported are listsd below. 



F.4»2 Sestrictions 

RECORD LENGTH 

Records shall be 128 bytes long. 

NO CC^TlKUAI'IOtl HEADER HEC0RI3 

The second record in a file aiuat be a data record. 

NO SOPPORT FOR MULTI-VOLUME PILES 

No support for raulti-volurne files is required. 

F.4.3 Inclusions 

The i»3tricted standard (as in^leroented <mder CAPS-^ll^ requires 
support for tine foll<?wing iteirta described in the full standards 

• The Pile Hame 

• Logical End of fape 

• Read the (first) header record 

• File Citation Date {may be blanks) 

F.5 SUPPORT FOR MULTI-VOLUME FILES 

The following inforskatiofi should act as a guideline to us^rs who wish 
to in^leinent raulti-voluine cassette support in their system. The 
easiest way to support multi -volume files is the "fall off the tape" 
method. Whenever the end of a tape is reached before a file has been 

closed, the system should type out a inessage to that effect and allow 
the user to mount miother tape, if necessary. 
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• On READ, the system should! 

1. Type out the message; 

2. If the user indicates that the end of file has been 

reached, the system should react as such; 

3. If the user indicates that end of file has not been 
reached, the system should allow the user to p.ount 
another tape, indicate the controller, and tell the 
system to continue processings 

4. The system should verify that there is a file on the tape 
with the sane nanie and the next higher volume nuriber as 
the previous file ; 

5. If that is the case, the system should continue 
processing the file. 

• On WRITE, the system should: 

1, Erase any partially-written record by backspacing two and 
forward-spacing one, and writing an EOP to the end of the 
tape;* 

2, Type out the message; 

3, Allow the user to niount a new tape; 

4, The system may either assume a blank tape, or space to 
logical end of tape; then write a file gap followed by a 
header record Cs) with the proper name and volume number; 

5, Continue processing. 

The other method involves using ths sentinel file, as outlined in the 

standard. The procedure is as follows; 

• on HEAD, the system should: 

1. Examine the next header record whenever it encounters a 
file gap; when there is no sentinel file at end of tape, 

assume end of file; 

2. If the header represents a sentinel file and the sequence 
byte is one greater than that of the file just being 
read, the system should request the user to mount another 
tape? if not, the nystem should report end of file; 

3. If a sentinel file indicates more volun^s exist , the 
system should allow the user to CD ntount another 
cassette, (2) indicate where it is, and (3) tell the 
system to continue processing; 



*When using 128-byte records, the hardware will never mistake the 
inter-record gap plus the erased tape for a file gap. This is 
possible when using larger records. Systems using such records should 
consider the second method for supporting multi"Voluine files. 
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4, The system shouM verify that there is a file on the tape 
with the asms name and the next higher volume nmnber as 
the previous file; 

5, If that is the case, the system should continue 
processing. 

• (to WRITE, when the system reaches the end of tape, it should j 

1. Erase enough records to allow a file gap and a sentinel 
file to be written (this involves doiible buffering in the 
case of large records, and triple or even quadruple 
buffering, in the case of small records} ; 

2. Write out a file gap, and request the operator to mount 
another cassette f 

3. If the operator indicates there will be no extra 
cassette, the system should (1] write out a sentinel file 
with a null sequence byte, and (2) tell the operator he 
can disntount the cassette (clearly, the operator loses 
some data if he does not mount another cassette) ; 

4. If the operator indicates he wishes to mount another 
cassette, the system should (1) write out a sentinel file 
with sequence byte equal to the current files sequence 
number plus one, and (2 J tell the operator he can 
dismount the cassette; 

5. The system should allow the operator to {IJ mount another 
tape, (2) indicate the controller and drive number that 
holds the tape, and C3) tell the system to continue 

processings 

6t The system should space to logical end of tape, then 
write a file gap followed by a header record (s) with the 
proper name and volume number, followed by the recsords 

erased from the previous cassette; and 

7. Continue processing* 

When processing cassettes that may have been written on the other 
systems, it may be wise for systems that support the full method for 
multi-volume files to support the "fall off the tape" method, too* 
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APPENDIX G 
CaPS"ll ASSEMBLY IHSTRUCTIONS 



G.l GENERAL INSTRUCTIONS 

Listed below are assembly instructions for the CAPS- 11 Monitor and 
system programs. Due to symbol table size, note that some of the 
system components cannot be assembled under the standard 8K CA.PS-11 
assembler, but require at least the 12K version of PAL, 

The following general instructions apply to ail assemblies in this 
appendix: 

1, Mount the system Cassette wrlte-locked on unit and 
bootstrap the CAPS-11 Monitor. 

2, When the Monitor is loaded and responds with a dot, 
type: 

3, itount the proper source cassette (obtained from the 
Software Distribution Center) on unit 1, write-loeked 
(this will be the cassette containing the first file in 
the input field of the cominand line) . 

4, Khen the Cortmand String Interpreter types an asterisk, 
enter the appropriate command string followed by a 
carriage return . 

5, When the prompt message (0?) is typed during the second 
pass of the assembly, dismount and the System Cassette 
from unit and mount an output cassette (on which the 

t binary OBJ files will be stored) write-enaibled on the 

unit; type any character to continue execution. 

NOTE 

r If the user's CAJPS-11 system is 12K or 

more, the /P (prompt option] is 
necessary only on the first assendsly. 
Since the system does not need to be 
rebooted between assemblies, the user 
may Jtwsunt one cassette on unit and 
(^ "' output as i!\any OBJ files as will fit 

before UKJunting a new cassette. 
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6. When the assembly is complete, PAL will type the 
message: 000000 ERRORS (with the exception of the 
Editor, in which there are several line buffer overflow 
errors? extra characters on a line greater thcin 72 
characters in length are iqnored and are indicated on 
the listing by an 'L message.) In an 8K system PAL will 
next respond by typing +C?; the user should dismount the 
cassette on unit 0, remount the System Cassette, and type 
any character on the console terminal to reboot the sys- 
tem. After this is done, return to step 2 above. 



NOTE 



If the system is 12K or larger, control 
will return to the CSI, which prints an 
asterisk. No reboot is necessary, and 
the user may proceed with the next 
assembly (step 4 above). 



7, Whenever a prompt message for unit 1 occurs, mount the 
source cassette containing the proper file (in 
parentheses) on unit 1 write- locked, and type any 
keyboard character. 

8, In all command lines, "PT: may be specified in place of 
LP:; however, several output listings will be extremely 
long and the use of the console terminal as the listing 
output device is not recommended. 



G.2 ASSEMBLY COMMAND LINES 

G.2.1 Keyboard Listener (KBL) 
*KBL/P*LP!=1SKBL.035 
PASS 2 
0"? see Step 5 

G.2.2 CABLDH 

*CABLDR/P*LP: = I: CABLDR.022 

PASS 2 

0? see Step 5 
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G.2,3 Conmaiid String Interpreter (CSI) 
*CSI/P#LP!«l! CSI.0M 
PASS 2 
0j see Step 5 

G,2.4 CLODll 

♦ O-ODI I/P*LP!=ISCL0D1 1.024 

PASS 2 

0? see Step S 

G.2.5 HESMON* 

*RESMCW/P,LPl« ltRESf^Or<.06S 

0? see Step 5 

G,2.6 CBOOT 

♦ CBOOT/P, LP! » 1 ! CBOOT. 007 
PASS 2 

0? see Step 5 

G.2.7 PIP* 

♦ PI P /P, LP£ = 1 1 P I P. 022 

PASS 2 

i? see Step 5 



* Requires miniraum 12K PAL assembler 
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G.2.8 CSIBBF 

*CSIf^BF/P,LPs=l!NOBUFr.PAR/P,CSITAC.03e/P 



!t 
1? 

PASS 2 
0? 



see Step 7 {NOBUFF.PAR> 

see Step 7 {CSITAC.032) 

see Step 5 

see Step 7 (NOBUPF.PAR) 

see Step 7 tCSITAC.032) 



G.2.9 EDIT* 

* EDI T/Pj, LP: » 1 1 CAPS 1 1 . PAR/P# EDI T. 0a3/P 
I? see Step 7 (CAPSll.PAR) 

I ? 



PASS 2 
0? 
I T 
1? 



see Step 7 (EDIT. 023) 

see Step 5 

see Step 7 {ciypsil.PAR) 

see Step 7 CE0IT.O23) 



G. 2 . 10 LINK* 

PASS 2 

®^ see Step 5 

C,2,ll CSITAC 

*CSI TAC/P#LPt a IS CSI TAG. B22 
PASS 2 

0* see Step 5 



*BBqiiii:ea ittinimuffi 12K PAL assembler 
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G.2.12 ODT 

*ODT/Pj,LPs=l!ODT.015 

PASS 2 

0? see Step 5 

G.2.13 PAL* 

« PAL/P#l-Pi » 1 s PAL I . eS"? /P* PAL2. e27/P, PAL3. 027/P 

I? see Step 7 (PM*1.027) 

I? see Step 7 (PAL2.02?) 

1? see Step 7 {PAL3.027) 

PASS 2 

0? see Step 5 

1? see Step 7 (PALI.. 027) 

1? see step 7 (PAL2.027) 

!? see Step 7 (PALS. 027) 

G.2,14 P8SXM (8K PAL Symbol Table) 

* Pa SlTM/P, L P: = I : P8 Sy?^ 
PASS 2 

S? see Step 5 

G.2.15 P12S5rM iVl% PAL Syinbol Table) 
*Pl2SYM/P*LPJ= ISPISSYM 
PASS 2 

0? see step 5 



♦aeguirea mlniinum 12K PAL assendbler 
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G.2.X6 PX6SYM (16K PAL Symbol Table) 
• Pt 6SYM/P,LP: = I! P16S¥"M 
PASS 2 
0? see Step 5 
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Absolute , 5-5 

binary foriaat, 3-18, b-5 

binary load block 
format, B-3 

mode , 5-20 

program sections, 6-6 
Accessing unstructured data, 

2-8 
Address mode syntax, B-2 

njodss, 2-7 

pointers, 2-5 

register display, 1-B 
Addressing, 2-4 
Addrejssing modes, 5-16 

absolute, 5-20 

autodecreraent, 5-13 

autoincrewent, 5-*17 

deferred auto^crement, S-16 

deferred autoincrement, 5-18 

deferred index, 5-19 

deferred register, 5-17 

deferred relative* 5-21 

index, 5-19 

register, 5—16 

relative, 5-20 
Addressing using PC, 5-19 
Altering register contents, 

5-37 
Arithmetic operators, 5-11 
ASCII, 

character oodes , A-2 

conversion, 5-12 

input and output, T-19 
Asaeiibler, PAL, 1-2, 5-1 

addressing laodes, 5-16 

calling and using, 5-1 

coding techniques, 5-37 

directives, 5-24, B-9 
conditional , B-10 

error codes, 5-47 

error messages, 5-48, C-9 

exaraple listing, 5-46 

ej^ressions , 5-10 

I/O specifications, 5-3 

language siurmary, B-1 

object itK^ule output, 5-46 

options, 5-2 

restarting, 5-3 

s tatemen ts , 5-4 

symbols, 5-7 
Assembling the source 

program, 5-1 
Aasesbly, 

command lines , G-2 

dialogue, 5-44 

instructions, G-1 

listing, 3-45, 5-46 

location counter, 5-12 
Assembly language stuionary, B-1 

instructions , B-3 

terminators , B-1 



Assigning values to symbols, 

5-8 

Autodecrement mode, 2-5, 

5-18 
Autoincrement mode, 2-5, 

2-S, 5-17 

Auxiliary header record, 
p-5 

Base address, 7-2 
Bits, 1-4 

Blank cassette, 1-5 
Blocks, Text, 5-46 
Breakpoint status words. 

Breakpoints , 7-20 

Buffer arrangement, 

transfer commands, 9-3 
unformatted cassette, 9-7 

Buffer size, 9-4 

Building memory 

configurations, E-11 

Byte count, 9-7 

Byte count word, 9-12 

Bytes, 1-4, F-2 
Unused, F-5 

CABIjuH, E — 2, Ei— 3 

halts, E-4 

switch register settings, E-4 
CAPS- 11 loading process , E-7 
CAPS-11 inemory map, 3-17 
CAPSll,r,DA, E-6 
CAPS 11. SYS, E-6 

Cassette, 1-3, P-2 

M>80lute Loader (CABLDR) , 3-18 

blank , 1-5 

Bootstrap (CBOOT) , 3-17, E~l 

dismounting a, 1-5 

format, 1-4 

Loader (CLODll) , 3-18, E-2 

Monitor, E-6 

mounting a, 1-5 

OBJ, 1-2 

removing a, 1-6 

Standards, F-1 

System, 1-2, 1-5 
Cassette file 1/0 commands, 9-14 

CLOSE, 9-18 

ENTER, 9-16 

SEEK, 9-14 

SEEKF, 9-15 
Cassette 1/0 functions, 9-24 
Cassette I/O primitives, 9-24 
CBOOT , 3— 2 , E— 1 , E— 8 

loader format, E-1, E-2 
Character, F-2 

null, 1-5 

set, 5-4 
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Checksum, 9-12 
Clear trailer, F-5 

Command and error messaget 
summaries, C-1 

Command input buffer (EDIT) , 

4-23 
Coirmand mode (EDIT) , 4-4 
Command String interpreter 

(CSX) , 3-6, 3-18 
Coramand siunmaries. 
Editor, C-4 
Monitor, C-1 

am, c-16 

CoPSi^nts , 5—6 
ConsMunications directory, 

6-7 
Coiaponenta , 

Hardware , 1-2 

Software, 1-2 
Condition code operates, B«7 
Condition codes, B-3 
Conditional directives, B-10 
Console, 

elements, 1-8 

operation , 1-7 

terminal OEie ration, 1-10 
Constant register, 7-15 
Contiguous relocating load, 

B-4 
Control sections, 

Naned, 6—6 

Unaraed, 6-6 
Control switches, 

PDP-ll/lO, 1-9 
Copying cassettes , 8-4 
Creating a new systein 

cassette, E-15 
CSI options, 3-7 
CSYSLD.LDA, E-6 
CTLOAD, SYS, E-2 

Data record, 1-4, F-2 
Data register display, 1-8 
Data trcinsfer coranands , 9-19 
KEAD, 9-19 

WRITE, 9-20 
Debugging the object 

prograjH (see ODT) 
Default extensions, 3-5 
Deferred, 

autcKiecrement mode, 5-18 

autoincreroent mode, 5-18 

index, 5-19 

modes, 2-7 

register mode, 5—17 

relative mode, 5—21 
Device , 

assignments, 9-3 

conflicts, 9-21 

dependent fxmctlons, 9-9 
9-12 

interrupts, 2-3 



Directives, 

.ASCII, 5-28 

« BxTB , 5—28 

conditional assembly, 5-30 

,EWD, 5-27 

.EOT, 5-26 

.EVEN, 5-26 

.GLOBL, 5-25 

.LIMIT, 5-30 

listing control, 5-30 

progr^En sections, 5-25 

♦HADSO, 5-29 

.TITLE, 5-24 

.WORD, 5-27 
Dismounting a cassette , 1-5 
Display, 

Address register, 1-8 

Data register, 1-8 
Done bit, 9-6 
Double buffering, 9-23, F-8 



EDIT [Text Editor) , 4-1 
calling and using, 4-1 
character command 

properties, 4-3 
closing files, 4-14 
command arguments , 4-6 
command string format, 4-6 
coratieuid strings, 4-7 
copwiand structure, 4-5 
coranand supimary* C-4 
current location 

pointer, 4—7 
error messages, 4-25, C-? 
exan^le of use, 4-27 
I/O specifications, 4-2 
input and output 

commands , 4-10 
key commands, 4-4 
line oriented command 

properties, 4-8 
modes of operation, 4-4 
options , 4-2 
restarting, 4—3 
search commands, 4-16 
text modification 

commands, 4-18 
utility commands, 4-22 



Editing the source program 

(see EDIT) 
Blianents of the console , 

1-8 
EMPTY header, 3-15, 9-16 
End of tape, F-5 
Entering I/O information, 

3-6 
Entry symbol, 5-8 
EOF bit, 9-6 
EOM bit, 9-6 
Error nessage format, 3-10 
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Error messaga summaries. 

Assembler, C-9 
Editor, C-7 
Linker, C-13 
Monitor, C-2 
DOT, C-19 
PIP, C-20 
RBSMJM, C-2 2 

Expressions, 5-10 

modes , 5-14 

terms, 5—10 
Extensions , 

Default, 3-5 

Filenaines and, 3-4 

File, 1-4 

creation date, F-5 

deletion, 8-3 

format s , 3—3 
ASCII, 3-3 
Binarf, 3-3 

gap, 1-4, F-2 

naise, F-3 

Sentinel, 1-5 

tjfpe, F-3 
Filenames and extensions, 

3-4 
Piles, sequential, 1-4 
Format , 

Cassette , 1-4 

control, 5-6 

Header record, F-3 
Fonrtatted, 

ASCII, 9-9 

Binary, 9-11 

cassette I/O, 9-7 
Full Standard, F-2 
Functional organization 
(ODT), 7-20 

General assembly 

instructions, G-1 

Global Syinbol Directory 

(GSD) , 5-15, 5-46, 6-7 

Global symbols, 6-7 

Hardware components, 1-2 
Header continuation byte, 
F-5 

Header record, 1-4, F-2, P-3 
Auxiliary, P-5 
format , F-3 

I/O buffer area, 9-3 
Iiwmediate mode, 5-19 
Index mode, 2-6, 2-8, 5-19 
Input /output, 

devices, 3-4 

prograraning, 9-1 



Instruction, 

capability, 2-9 
forms, 5-23 
set, 2-4 

Instructions, 
asseiiibly, G-1 
branch, B-7 
double operand, B-4 
operation, B-6 
rotate/shift, B-5 
single operand, B-4 
subroutine call, B-8 
subroutine return, B-9 



Internal registers, 7-9 
Internal symbols, 6-7 
Interrupt vectors, 2-4 
Interrupts, 2-10 
XOT instructions, 9-2 
Iteration brackets , 4-9 

Keyboard, 

differences, A-1 

LA30 DECwriter, 1-11 
Listener £KBLJ , 3-18 
Monitor loading process, 

3-1, E-1 
Monitor sections, 3-16 



LA30 DECwriter, 

keyboard, 1-11 

parallel, 1-12 

serial, 1-11 
Labels, 5-4 

Leader/trailer tape, 1-3 
Linker, 6-1 

calling and using, 6-2 

error message sunmary, C-13 

example of use, 6-13 

fatal errors, 6-10 

input and output, 6-7 

input and output 

specifications, 6—5 

non-fatal errors, 6—9 

options , 6-2 

restarting, 6-5 
Linking , 

Relocation amd, 5-15 
Load map, 6-5, 6-8 
Load module, 6-S , 6-7 
Loading unused trap vectors , 

5-36 
Locking bar, 1-S 
Logical operators, 5-11 
LSll line printer operation, 

1-12 
LSll operator panel, 1-12 
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Macro buffer (EDIT) , 4-23 
Mask register, limits, 7-14 
Memory block initialization, 

7-15 
Memory map, CAPS- 11, 3-17 

Miairaal system 

configuration, 1-2 
Mode, 

Autodecrement, 2-5 

Autoincrernent, 2-5, 2-8 

Index, 2-6, 2-S 

Radlx-50, 7"3 

Register, 2-5 

Relative, 2-8 

Single-instruction, 7-13 
Mode CEDIf) , 

coRuoand, 4-4 

Mode byte, 9-4, 9-17 



Modes , 9-7 

deferred, 2-7 
formatted ASCII , 9-9 
formatted binary, 9-11 
non-deff erred, 2-7 
unformatted ASCII, 9-11 
unformatted binary, 9-12 
Modes of expressions, 5-14 
abso lute , 5-14 
external, 5-14 
relocatable, 5-14 
Monitor, 1-2 

commands , 3-11 , C-1 

DATE , 3— 1.4 

DIRECTORS', 3-14 

LOAD, 3-13 

RUN, 3-11 

SENTINEL, 3-15 

START, 3-13 

VERSICW, 3-16 

ZERO, 3-15 
error messages, 3—24 
loading instructions , 3—1 
reconfiguring, E-12 
sections, 3-16 

CABLDR, 3-18 

CBOOT f 3'**'i7 

CLODIl, 3-ie 

K£rJL* f 3*"X8 
RESMON, 3-17 
SYSCOM, 3-18 
Mounting a cassette, 1-5 

Multi-volume files, F-6 

Named control sections , 6-6 
Nested device servicing, 2-10 

N on- contiguous relocating 

load, E-4 



Non-data transfer commands, 
9-12 

CNTRLO, 9-13 

RESET, 9-13 

RESTART, 9-13 
Non-defferred modes, 2-7 
Non- fatal off-line and 

write- lock errors, 9-18 
Normal load, E-4 
Notes on device handlers, 

3-2 3 
Null characters, 1-S, 3-12 
Numbers, 5-11 

declreal , 5- 11 

octal, 5-11 

OBJ cassettes, 1-2, E-11 
Object module output, 5-46 

Ctoject incsdules, 6-7 



ODT, 1-2, 7-1 

accessing general 

registers, 7-B 
accessing internal 

registers, 7-8 

calculating offsets, 7-16 
calling and using, 7-1 
changing locations, 7-5 
closing locations, 7-5 

commands and functions, 

7-4, C-i6 
error detection, 7-26 
error message suniaary, C-19 
example of use, 7-26 
I/O specifications, 7-2 
mask register, 7-14 
opening locations, 7-5 
options , 7-2 
printout formats , 7—4 
priority level, 7-18 
program execution, 7-11 
relosaticm register 

commands, 7-17 
restarting, 7-2 
restoring terminal 

status, 7-24 
searches, 7-14, 7-25 
trace trap instruction, 
7-21 

Operands t 5-6 

Operation, Console, 1-7 

Operator panel, LSll, 1-12 

Operators ,_ 5-5 

rLJUJkt lant lil'Hi# lnf iJi: ^ If «l -XwXw 

Logical, 5-11 
Option summary. 

Assembler, C-B 

Linker, C--12 

PIP, C-19 
Overlay load, 6-4 
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Packing algorithm, 5-29 

Page size, 5-7 

PMi assembler, (see Assembler) 

PDP-11/10 control switches, 
1-9 

PDP-11/10 prograramer's 
console , 1-7 

Peripheral Interchange 
Program, (see PIP) 

Permanent ttevice names, 3-4 

Permanent symbol table, 5-7 

PIC coding, 5-32 

PIP, 1-3 

Calling and using, 8-1 
Error messages, 8-5, C-20 
I/O specifications, 8-2 
Options, 8—1 
Restarting, 8-5 

Pointer relocation commands, 
4-14 



Position independent modes, 
5-32 
absolute, 5-33 

immediate operands, 5-33 

relative memory references, 
5-32 

Processor status register, 
2-3 

Program counter, 2-4, 2-8 
Program runaway, 7—23 
Program sections. 
Absolute , 6-6 
Relocatable, 6-6 
Programmer's console 

(PDP-n/10) , 1-7 
Programming considerations, 

7-20 
Ptx^g ramming the PDP-11, 2-1 
Push and pop operations, 

2-6 
Push-down lists, 2-6 

QCBOOT, 3-2, E-9 

Radix 50 mode, 7-9 

Hadix 50 terminators, 7-10 

rvAIiOOTIt AOC«@3S OX Xi^^loX^S f 

2-6 

Reconfiguring system programs, 

E— 13 — E— 15 
Reconfiguring the Monitor, 



Itecord, 

Data, 1-4 

gaps , 1-4 , F-2 

Header, 1-4 

length, F-4, F-6 
Recursive subroutines, 5-41 
Register Switch, 1-8 
Register display, 

Address, 1-8 

Data, l-a 
Register, 2-4 

mode, 2-5, 5-16 

symbols, 5-9 
Relative br^^ch offset, 7-7 
Relative iiKwle, 2-8, S-20 
Relocatable, 5-5 

expressions, 7—3 
forms , 7— 3 

crtiject modules, 5-15, 7-2 

program sections, 6-6 
Relocating load, E-4 
Relocating pointers, 5-35 

Bs location, 7-2 
and linking, 5-15 

bias, 7—2, 7—17 
calculators, 7-18 
factor , 5—5 
registers, 7-3 
Relocation Directory {a.0) , 

5-15, 5-46, 6-7 
Removing a cassette, 1-6 
Repeat (proceed) count, 

7-14 
Repetitive execution (EDIT) , 

4-9 
Resident Monitor (HBSMON) , 
1-3, 3-17 
communicating with, 9-1 
error messages, 9-25, C-22 
example, 9-2, 9-26 
non-fatal error codes, 9-5 
Restricted cassette 

standard, r-6 
Rewind button, 1-5 

Save buffer (EDIT) , 4-23 
Sentinel file, 1-5, F-2, 

F-5 
Sequence ntartber, P-S 
Sequential files, 1-4 
Serial 1A30 DECwriter, 1-11 
Setting up the stack 

pointer, 5-35 
Setting m^ trap for 

interrupt vectors , 

5-35 
Single buffer transfer on 

one device, 9-22 
Single- instruction mode, 

7-13 
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Software components, 1-Z 
Software support 

information i E-1 
Special characters and 
comiaands, 3-8 

CTRL/C, 3-9 

CTRL/0, 3-9 

CTRL/P, 3-10 

CTRL/U, 3-10 

RUBOUT, 3-10 
Stack operations, 2-6 
Standard (Cassette}, F-1 

Full, F-2 

Restricted, F-6 
Standard hardware devices, 

E-11 
Starting a program, 1-10 
S ta temen t s , 5-4 

comnents , 5-6 

labels, 5-4 

operands, 5-6 

operators, 5-5 
status byte, 9-5 
Status register format, 2-3 
Status/error byte, 9-17, 

9-24 
Subroutines, 2-9, 5-38 

Recurs ive, 5-41 
Summaries , 

COTraiiand and error message, 
C-1 
Switch register, 1-8 

Symbols, 5-7 
permanent, 5-7 
register, 5-9 

uaer-defined, 5-7 

SYSCOM, 3-17 

general locations, 3-19 
special locations, 3-20 

System, 

cassette, 1-2, 1-5, 3-1 

directory, 3-1 
communication (SYSCOM) , 3-18 
configuration, minimal, 1-2 
conventions , 3-3 
demonstration, D-l, D-2 
diagrsHft, 2-2 
start-up, D-1 
structure, 2-1 



Tab stops, 3-23 

Table of breakpoints, 7-11 

Table of raode forms and 

codes, 5-21 
Table of proceed counts, 

7-12 
Table of relocation 

registers, 7-1? 
Text blocks, 5-46 
Text buffer (EDIT), 4-10, 

4-23 
Text Editor (see EDITJ 
Text mode {EDIT} , 4-4 
TRA block, 6-8 
Transfer mode , 9-4 
Transferring files, 8-4 
Trap vectors, 5-37 
Traps, 2-10 
Two pass assembler, 5-1 

Unained control sections, 

6-6 
unformatted, 
ASCII, 9-11 

Binary, 9-12 

Cassette I/O, 9-7 
UNIBUS, 2-3 
Unused bytes, F-5 
User progrsKt loading 

process, 3-21 
User prorating, 9-17 
Oaer-^fined syndsols, 5-7 

global , 5-8 

internal , 5-8 
Using the CAPS -11 Monitor, 
3-1 

WAITR vs. testing buffer 
done bit, 9-22 

WHITE, P-7 

Wrlte-protect tabs, 1-3 

Writing, 

automatic PIC, 5-34 
non-automatic PIC, 5-35 
position independent 
code (PIC) , 5-32 

Zeroing a cassette, 8-2 
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CAPS-11-USER'S 3UIDE 
DEC-ll-OTUGA-A-D 



READER'S COMMENTS 



NOTE: This form is for docuwent comments only. Problems 
with software should be reported on a Software 
Problem Report (SPR) form. 



Did you find errors in this manual? If so* specify by page- 



Did you find this manual understandable, usable, and well-organized? 
Please make suggestions for improvement. 



r 



c 



o 



3 






Is there sufficient docuroentation on associated system programs 
required for use of the software described in this manual? If not, 
what material is missing and where should it be placed? 



Please indicate the type of ijser/reader that you most nearly represent. 

1 1 Assembly language programmer 

[3 Higher-level language programmer 

r~1 Occasional programmer (experienced) 

Q User with little programming experience 

Q Student programmer 

I 1 Non-programmer interested in computer concepts and capabilities 



Name. 



Date. 



r 



Organization. 



O Xli fi^'t. . 



city. 



, State. 



.zip Code. 

Country 



If you require a written reply, please check here. 



a 



■F<rild Hefe— — 



- Ih> tm Tear - Fold Hsre and Staple ■ 



FHtSf CLASS 
PERMIT NO. 33 

MAYNARB, MASS. 



BUSINE^ REPLY MAIL 

NO POSTAGE STAMP NECESSARY IF MAILED IN THE UNITED STATES 



Fostace will be paid by: 



Digital Equipment Corporation 
Software Conununications 
P.O. Box F 

Maynard, Mass. 01754 
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